/ bad_response_status_code

🔍 错误分析

1. 🌐 错误翻译

原文：HTTP 400，openai_error / bad_response_status_code
译文：HTTP 400，OpenAI错误 / 响应状态码错误

2. 🎯 原因分析

该错误表明向 OpenAI API 发起的请求被服务器拒绝，返回了 400 错误状态码，属于客户端请求错误。常见根本原因包括：

请求参数格式错误：如缺少必填参数、参数类型不符、字段名称拼写错误

无效的请求数据：如 JSON 格式错误、传入的数据不符合字段要求

认证信息错误：如 API Key 无效、缺失或格式不正确

请求超时或过大：如消息内容过长、超出模型限制

3. 💡 解决方案

#### （1）检查并修复 API Key
确保环境变量或代码中配置的 OpenAI API Key 正确有效：

// 检查代码中的API Key配置
const openai = new OpenAI({
  apiKey: 'sk-your-valid-api-key', // 确保是有效的Key，不要写占位符
  baseURL: 'https://api.openai.com/v1', // 官方地址，避免使用代理
});

#### （2）验证请求参数格式
以调用聊天接口为例，确保参数符合 API 规范，必填字段齐全、格式正确：

// 修复后的完整请求示例（以聊天接口为例）
const response = await openai.chat.completions.create({
  model: 'gpt-4', // 必须指定有效的模型名称
  messages: [
    {
      role: 'user', // 角色必须是'system'/'user'/'assistant'之一
      content: '你好，请帮我解答一个问题' // 内容不能为空
    }
  ],
  temperature: 0.7 // 可选参数，格式符合要求
});

#### （3）排查请求数据问题

避免传入超大文本内容，若消息过长，可先截断或分拆处理

检查请求体 JSON 格式，确保没有语法错误（如多余的逗号、缺失引号）

使用工具验证 JSON 格式：JSONLint

4. 🛡️ 预防措施

参数校验前置：在发起请求前，对必填参数、格式、取值范围进行严格校验，可使用 TypeScript 类型约束减少错误

启用调试日志：开启请求日志，记录请求参数和响应信息，便于快速定位 400 错误的原因

使用官方 SDK：优先使用 OpenAI 官方提供的 SDK，避免手动拼接请求导致的格式错误

参考 API 文档：严格按照 OpenAI 最新 API 文档核对参数名称、类型和必填性，避免使用过时的参数