API 金鑰錯誤導致 ChatGPT Claude Gemini 無法呼叫的 5 個排查思路

你寫好了程式碼、配好了提示詞，結果一執行就報錯：Invalid API key、401、403、Access denied……真的很像「我明明沒做錯什麼」。這類問題在 ChatGPT、Claude、Gemini 的 API 呼叫裡最常見，Midjourney 如果你用第三方介面轉接，也一樣會踩坑。

1 金鑰貼錯位置或帶了空格

最多人中招：複製時把換行、前後空格一起帶過去，或者把 Key 填到 Base URL 的位置。建議把 Key 重新複製一遍，手動檢查首尾字元。

2 環境變數沒生效

你以為已經 export 了，其實服務沒重啟；本地能跑，部署到伺服器就翻車。把程式啟動時印一行「是否讀取到 KEY 長度」比盲猜快多了。

3 用了錯誤的專案或帳號權限

有些平台的 Key 跟「專案/組織」綁定，換了專案就直接 401；還有的 Key 被你不小心刪了、停用了。去控制台確認狀態，不要跟自己較勁。

4 網路或地區存取受限

403 不一定是 Key 錯，可能是網路被攔、出口 IP 不乾淨。先用官方控制台的測試功能驗證 Key，再去排網路。

5 依賴與建置問題偽裝成 Key 錯誤

我見過 Node 專案因為依賴衝突（ERESOLVE）、版本不存在（ETARGET）、目錄殘留（ENOTEMPTY）導致請求庫沒正常發出去，最後統一報「認證失敗」，特別氣人。先把建置跑乾淨，再判斷 Key。

快速自檢清單

• 同一把 Key 在官方示例/控制台能否成功
• Key 是否有空格、是否過期、是否被停用
• 環境變數是否在執行行程裡真實存在
• 錯誤碼是 401 還是 403，分開處理
• 依賴安裝是否無報錯後再啟動服務

如果你還在為訂閱、支付、地區限制或帳號異常反覆折騰，省點時間，去 Titikey 看看更穩的解決路徑和工具清單，少踩坑真的能省一大截精力。