ChatGPT报错全解析：从常见错误到高效排查指南

1次阅读

共计 1887 个字符，预计需要花费 5 分钟才能阅读完成。

ChatGPT API 的报错可以归纳为以下几大类，每种类型对应不同的处理策略：

认证类错误（401/403）
通常由无效 API Key 或权限问题导致。检查点：
API Key 是否包含多余空格或换行符
账号是否欠费或被封禁
请求头 Authorization 格式是否正确（需包含 Bearer 前缀）
限流类错误（429）
高频触发场景：
RPM（每分钟请求数）超限
TPM（每分钟 token 数）超限
关键响应头：
x-ratelimit-limit-requests
x-ratelimit-remaining-tokens
输入校验类（400）
常见子类型：
invalid_request_error：参数缺失或格式错误
content_policy_violation：触发内容过滤规则
context_length_exceeded：上下文超长（gpt-3.5-turbo 通常限 4096 tokens）
服务端错误（5xx）
临时性服务不可用，建议：
查看 OpenAI 状态页（status.openai.com）
实现自动重试机制

检查 HTTP 状态码
curl -v或浏览器开发者工具查看原始响应

解析错误体
典型错误结构：

{
  "error": {
    "message": "You exceeded your current quota...",
    "type": "insufficient_quota",
    "code": "invalid_api_key"
  }
}

分析响应头
重点关注：
x-request-id：用于向 OpenAI 提交工单
retry-after：429 错误时的建议等待秒数
验证请求参数
使用官方 Playground 对比测试请求体

import openai
import time
from tenacity import (
    retry,
    stop_after_attempt,
    wait_exponential,
    retry_if_exception_type
)

@retry(stop=stop_after_attempt(3),
    wait=wait_exponential(multiplier=1, min=4, max=10),
    retry=retry_if_exception_type(openai.error.APIError)
)
def chat_completion_with_retry(prompt):
    try:
        return openai.ChatCompletion.create(
            model="gpt-3.5-turbo",
            messages=[{"role": "user", "content": prompt}]
        )
    except openai.error.RateLimitError as e:
        print(f"Rate limit hit: {e}")
        raise

def truncate_context(messages, max_tokens=3000):
    """从后向前裁剪消息历史，确保总 token 数不超过限制"""
    while True:
        token_count = num_tokens_from_messages(messages)
        if token_count <= max_tokens:
            break

        # 优先移除最早的对话
        if len(messages) > 1:
            messages.pop(0)
        else:
            # 单条消息过长时强制截断
            messages[0]["content"] = messages[0]["content"][:-500]
    return messages