# 從症狀出發排障:z-request-id 定位 401 / 502 / 流式中斷

> AI gateway 排障:z-request-id 端到端定位 401 / 403 / 404 / 502 / 503 / 逾時 / 流式中斷 / 記憶體異常,錯誤碼正規化,流式不緩衝。從症狀出發不必再猜。

規範連結: https://www.gatellm.io/zh-TW/use-cases/troubleshooting/

按 z-request-id 端到端定位 401 / 403 / 404 / 502 / 503 / 逾時 / 流式中斷 / 記憶體異常 —— 不必再猜。

## 社群真正在抱怨什麼
StackOverflow 高頻:"流式回應經代理後變成一坨"、"tool calling 的 JSON 拼不起來"、"429 到底是限流還是配額超了"、"502 是閘道器還是廠商的鍋"。
AI 呼叫排障難在:多跳路徑、流式、錯誤碼不統一,出問題不知道卡在哪一跳。

## GateLLM 怎麼做
GateLLM 給每個請求分配 z-request-id,端到端串聯日誌,按症狀定位:401 / 403 看鑑權與 Header ACL,404 看路由,502 / 503 看上游健康,逾時看限流與跨海,流式中斷看緩衝與 SSE,記憶體異常看設定。
錯誤碼正規化(多廠商錯誤語義統一),流式原生透通不緩衝,Token Ops 日誌可查可匯出。

## 落地的 5 個手段
- z-request-id 端到端串聯日誌,按 id 一鍵定位
- 按症狀分流:401 / 403 / 404 / 502 / 503 / 逾時 / 流式中斷 / 記憶體異常
- 錯誤碼正規化:多廠商錯誤語義統一為一致口徑
- 流式原生透通不緩衝,不破壞 SSE 與 tool calling
- Token Ops 日誌可查可匯出,接入排障與對帳

## 常問問題
### AI 閘道器流式回應經代理後不流式了?
劣質代理會緩衝流式回應。GateLLM 原生流式透通不緩衝,並做能力正規化,不破壞 SSE 與 tool calling。

### 429 是限流還是配額超了怎麼區分?
z-request-id 端到端定位 + 錯誤碼正規化,區分限流 429 與配額超 429,按症狀排障不必再猜。

- [檢視完整方案:從症狀出發排障(docs 站)](https://docs.gatellm.io/zh-CN/usecases/troubleshooting)

## 相關頁面
- [首頁](https://www.gatellm.io/zh-TW/index.md)
- [定價](https://www.gatellm.io/zh-TW/pricing.md)
- [成本計算器](https://www.gatellm.io/zh-TW/calculator.md)
- [關於](https://www.gatellm.io/zh-TW/about.md)
- [預約示範](https://www.gatellm.io/zh-TW/demo.md)
- [常見問題](https://www.gatellm.io/zh-TW/faq.md)
- [比較 AI 閘道](https://www.gatellm.io/zh-TW/compare.md)
- [比較 LiteLLM](https://www.gatellm.io/zh-TW/compare/litellm.md)
- [比較 OpenRouter](https://www.gatellm.io/zh-TW/compare/openrouter.md)
- [比較 Alibaba Cloud AI Gateway](https://www.gatellm.io/zh-TW/compare/alibaba-cloud.md)
- [比較 Azure API Management](https://www.gatellm.io/zh-TW/compare/azure-apim.md)
- [比較 Apigee](https://www.gatellm.io/zh-TW/compare/apigee.md)
- [比較 Cloudflare AI Gateway](https://www.gatellm.io/zh-TW/compare/cloudflare.md)
- [比較 Kong AI Gateway](https://www.gatellm.io/zh-TW/compare/kong.md)
- [比較 Portkey](https://www.gatellm.io/zh-TW/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-portkey.md)
- [場景方案](https://www.gatellm.io/zh-TW/use-cases.md)
- [降低呼叫成本](https://www.gatellm.io/zh-TW/use-cases/reduce-cost.md)
- [達成高可用](https://www.gatellm.io/zh-TW/use-cases/high-availability.md)
- [多租戶隔離](https://www.gatellm.io/zh-TW/use-cases/multi-tenant.md)
- [合規與稽核](https://www.gatellm.io/zh-TW/use-cases/compliance-audit.md)
- [混合多供應商模型堆疊](https://www.gatellm.io/zh-TW/use-cases/mixed-model-stack.md)
- [在 Office 內自架 AI](https://www.gatellm.io/zh-TW/use-cases/self-hosted-office-ai.md)
- [Token 用量可見性與歸因](https://www.gatellm.io/zh-TW/use-cases/token-ops.md)
- [Token FinOps: AI 支出分攤與管控](https://www.gatellm.io/zh-TW/use-cases/token-finops.md)
- [MCP 工具治理](https://www.gatellm.io/zh-TW/use-cases/mcp-tool-governance.md)
- [為所有模型統一加入網路搜尋](https://www.gatellm.io/zh-TW/use-cases/web-search-grounding.md)
- [多 Key 輪替與備援](https://www.gatellm.io/zh-TW/use-cases/multi-key-pooling.md)
- [限制接入的用戶端](https://www.gatellm.io/zh-TW/use-cases/client-admission-control.md)
- [強制模型使用政策](https://www.gatellm.io/zh-TW/use-cases/enforce-model-policy.md)
- [用戶端不暴露模型選擇](https://www.gatellm.io/zh-TW/use-cases/automatic-model-tiering.md)
- [一種協定,任何模型](https://www.gatellm.io/zh-TW/use-cases/one-protocol-any-model.md)
- [Office / Microsoft 365 增益集](https://www.gatellm.io/zh-TW/office-addin.md)
- [術語表](https://www.gatellm.io/zh-TW/glossary.md)
- [模型目錄](https://www.gatellm.io/zh-TW/models.md)
- [SDK 與框架整合](https://www.gatellm.io/zh-TW/integrations.md)
- [AI Coding Agent 與 Harness](https://www.gatellm.io/zh-TW/coding-agents.md)
- [安全性與合規](https://www.gatellm.io/zh-TW/security.md)