做自動化腳本、Bot或者接工作流時,最崩潰的不是寫程式碼,而是突然冒出API key invalid、401、403、網路逾時。別急,這篇我按自己踩坑順序,給你一份「照著查就能定位」的清單,ChatGPT、Claude、Gemini都通用。
先看報錯類型 別一上來就重裝
很多人把所有問題都當「金鑰錯了」,結果白折騰。
- 401:金鑰無效、沒帶上、格式拼錯、專案沒開通
- 403:權限不足、地區/風控限制、額度策略攔截
- 429:限流或額度用完
- 逾時/ENOTFOUND:網路/DNS/代理問題,跟金鑰沒關係
API金鑰無效的高頻原因
參考一些外掛排錯經驗裡提到的「API金鑰錯誤」和依賴配置坑,我總結最常見的就這幾類:
- 複製多了空格或換行:尤其是環境變數裡,末尾多一個空格就能讓你懷疑人生
- 用錯了平台的Key:OpenAI、Anthropic、Google的Key不能混用,別把Gemini的Key塞進Claude設定裡
- 請求標頭寫錯:Authorization前綴、Header欄位名大小寫、Bearer漏寫
- 專案沒開通計費/權限:Key是真的,但帳號沒開通對應API權限,也會被拒
403存取受限 重點查地區和出口
403最煩,因為它經常不告訴你「到底哪裡不行」。我的經驗是先查出口IP和代理規則,再查帳戶權限。


