AI故障手册Content-Type 漏 charset（xAI）
中文 body 被网关误解析。 场景：xAI。charset=utf-8。
阅读(8)赞 (0)
所有文章 第18页
API 用了 http:// 被重定向丢头（Qwen）
强制 https。 场景：Qwen。http API。
阅读(6)赞 (0)
路径写成 /v1/v1（OneAPI）
根地址已含 /v1 又拼一次。 场景：OneAPI。/v1/v1。
阅读(7)赞 (0)
Base URL 末尾 # 导致路径丢失（Dify）
Cherry 常见。 场景：Dify。Base URL hash。
阅读(6)赞 (0)
Key 放错头：Authorization vs x-api-key（Ollama）
Anthropic 和 OpenAI 头不同。 场景：Ollama。x-api-key。
阅读(8)赞 (0)
412 Precondition Failed（OpenRouter）
ETag/If-Match 对不上。 场景：OpenRouter。412。
阅读(7)赞 (0)
409 Conflict：资源被占用（FastGPT）
别的进程在拉同一流。 场景：FastGPT。409 Conflict。
阅读(6)赞 (0)
499 Client Closed Request（vLLM）
客户端先断开，常见超时设太短。 场景：vLLM。499。
阅读(6)赞 (0)
504 Gateway Timeout：等上游超时（OpenHands）
拉长超时前先确认上游活着。 场景：OpenHands。504 Gateway Timeout。
阅读(7)赞 (0)
502 Bad Gateway：边缘到源站坏了（Aider）
502 先看源站进程，不是模型 500。 场景：Aider。502 Bad Gateway。
阅读(8)赞 (0)