一、401 / 403：认证与权限
先确认密钥是否完整复制、是否被删除或超额；再确认请求头格式是否为 Authorization: Bearer sk-***。如果密钥正确仍然报错，检查是否误用了另一个环境的密钥。
二、404：模型 ID 写错
模型 ID 区分大小写与符号，deepseek-v4.1-flash 与 DeepSeek-V3.2 是两种完全不同的写法。建议直接从模型目录复制 ID，不要手打。
三、429：触发限流
429 表示请求频率或并发超过限制。处理办法是加指数退避重试、把并发降到阈值以下，或把部分请求切换到其他模型。批量任务建议排队执行，不要一次性打满。
四、超时与流式中断
长文本生成时最容易出现。把客户端 timeout 调到 60–120 秒；使用流式输出时，注意有些网关会限制单连接时长，需要在客户端做断线续传或分段请求。
五、5xx：上游抖动
500、502、503 多数来自上游或链路抖动。正确做法是自动重试一到两次并记录请求 ID；如果同一模型持续失败，先切到备用模型保证业务可用。
六、报给支持时要带什么
- 请求时间（精确到秒）、模型 ID、接口路径；
- 完整的错误响应体与 HTTP 状态码；
- 是否使用流式、请求的 token 规模；
- 同一密钥下的成功请求示例，便于对比。
把这几项整理好，支持人员通常能在几分钟内定位到具体环节。