ERROR CLINIC
爆錯診斷中心
不知道它是哪一課沒關係。把 error 關鍵字、HTTP status 或症狀打進來，先定位「哪一層壞掉」。
固定問六件事：誰報錯？在哪台機器？哪個 process/service？最後成功步驟？第一個失敗步驟？有什麼 evidence？
不知道錯誤名稱？從症狀反查
| 症狀 | 先查哪一層 |
|---|---|
| 網域名稱完全找不到 | DNS / domain |
| 有 IP，但 connection refused | port / listening service / firewall path |
| HTTP 401/403 | authentication / authorization |
| HTTP 502 | gateway/proxy → upstream |
| API 200 但資料空 | query/filter/RLS/data，再查 render |
| 本機正常、production 壞 | environment/config/version/dependency |
| 排程手動跑正常，自動跑失敗 | identity/working directory/env/permissions |
Error message 使用原則
錯誤文字是證據，不是 root cause 本身。搜尋錯誤時保留精確 message、stack trace、status code、發生時間與操作步驟；但不要把 token、password、API secret 貼進公開搜尋或 issue。