ChatGPT报错处理指南：从新手到高手的避坑手册

1次阅读

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

初次使用 ChatGPT API 时，报错主要集中在以下三类（按出现频率排序）：

HTTP 状态码错误：API 请求层面的问题
401 Unauthorized：API 密钥无效或过期
400 Bad Request：请求参数格式错误
429 Too Many Requests：触发速率限制
参数校验错误：业务逻辑层面的问题
max_tokens 超出模型上下文窗口
temperature 值超出 0 - 2 范围
消息列表格式不符合 message 协议
上下文管理错误：对话连续性相关的问题
多轮对话中丢失历史消息
角色标识（role）使用错误
上下文长度超过模型限制

import openai

try:
    response = openai.ChatCompletion.create(
        model="gpt-3.5-turbo",
        messages=[{"role": "user", "content": "Hello!"}]
    )
except openai.error.AuthenticationError as e:
    # 重点检查项：# 1. OPENAI_API_KEY 环境变量是否设置
    # 2. 密钥是否包含多余空格
    # 3. 账户是否欠费
    print(f"认证失败: {e.http_status}") 
    print(f"解决方案: {e.user_message}")

try:
    # 高频请求示例
    for _ in range(100):
        openai.ChatCompletion.create(...)
except openai.error.RateLimitError as e:
    # 官方限流策略：# RPM（每分钟请求数）: 免费用户 3, 付费用户 3500
    # TPM（每分钟 tokens 数）: 免费用户 40k, 付费用户 90k

    # 推荐解决方案：# 1. 实现指数退避重试
    # 2. 监控 X -RateLimit-Reset 响应头
    print(f"当前配额: {e.headers.get('x-ratelimit-limit-requests')}")

检查基础配置
验证 API 终端节点（注意区域差异）
确认 SDK 版本（pip show openai）
结构化日志记录

import logging

logging.basicConfig(format='%(asctime)s - %(levelname)s - %(message)s',
    level=logging.INFO
)

logger = logging.getLogger(__name__)

# 在请求前后添加日志
logger.info(f"Request: {messages}")
try:
    response = openai.ChatCompletion.create(...)
    logger.info(f"Response: {response}")
except Exception as e:
    logger.error(f"Error: {str(e)}", exc_info=True)

参数验证工具

from pydantic import BaseModel, confloat

class ChatParams(BaseModel):
    temperature: confloat(ge=0, le=2)  # 自动验证范围
    max_tokens: int

# 使用示例
try:
    params = ChatParams(temperature=1.5, max_tokens=2048)
except ValueError as e:
    print(f"参数校验失败: {e}")

上下文可视化

def print_conversation(messages):
    for msg in messages:
        print(f"{msg['role'].upper()}: {msg['content']}")
    print("-"*50)

import time
import random
from tenacity import retry, stop_after_attempt, wait_exponential

@retry(stop=stop_after_attempt(3),
    wait=wait_exponential(multiplier=1, min=4, max=10)
)
def safe_completion(messages):
    try:
        return openai.ChatCompletion.create(
            model="gpt-3.5-turbo",
            messages=messages,
            timeout=10  # 重要：设置超时
        )
    except openai.error.APIError as e:
        if e.http_status >= 500:
            # 服务器错误需要重试
            raise
        # 4XX 错误直接抛出
        raise e

# 使用 Sentry 监控示例
import sentry_sdk

sentry_sdk.init(dsn="your_dsn")

try:
    response = safe_completion(messages)
except Exception as e:
    sentry_sdk.capture_exception(e)
    # 降级处理
    return {"error": "Service temporarily unavailable"}