wrangler code 9106 Token 問題解決方案

📅 2026-04-08　🏷️ wrangler Cloudflare Token

📌 問題背景

執行 npx wrangler pages deploy 時出現 code 9106 Authentication failed 錯誤，但 npx wrangler whoami 可以正常顯示帳號資訊。

🔍 分析過程

第一步：檢查 Token 有效性

使用 REST API 直接查詢 deployment 列表 → ✅ 成功
wrangler whoami → ✅ 成功顯示帳號
結論：Token 本身有效，不是權限問題

第二步：查閱技能文件尋找解決方案

查閱以下技能文件：

upload-html SKILL.md 第 55-71 行
cloudflare-guard SKILL.md 第 217-336 行
env-setup SKILL.md 第 24-35 行

第三步：發現關鍵差異

upload-html SKILL.md 明確記載（第 71 行）：

⚠️ 必須同時設定 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID，否則 wrangler 會報 code 9106 錯誤。

第四步：驗證假設

之前只設定了 CLOUDFLARE_API_TOKEN，但 缺少 CLOUDFLARE_ACCOUNT_ID。

✅ 最終結論

問題根源：wrangler 部署時需要同時有兩個環境變數：

CLOUDFLARE_API_TOKEN — API Token
CLOUDFLARE_ACCOUNT_ID — 帳號 ID

解決方案：在 PowerShell 中同時設定兩個變數後再執行部署：

$env:CLOUDFLARE_API_TOKEN = [Environment]::GetEnvironmentVariable("CF_API_TOKEN", "User")
$env:CLOUDFLARE_ACCOUNT_ID = "2f2795bc4a98928375b23c36140ba33b"
cd "C:\Users\Administrator\WorkBuddy\wh-all-deploy"
npx wrangler pages deploy . --project-name wholistics --commit-dirty true

📋 關鍵教訓

✅ wrangler whoami 成功不代表部署會成功
✅ 部署需要 兩個環境變數 同時存在
✅ 遇到問題時先查閱 skill 文件，裡面已有解決方案
✅ 參考 upload-html 和 env-setup 技能的標準做法

🔗 相關技能

upload-html — 標準部署流程（含雙環境變數設定）
env-setup — WorkBuddy 重裝後環境恢復
cloudflare-guard — Direct Upload API 備用方案

← 返回首頁