Vercel 協同合作注意事項 — 編譯摘要

濃縮

核心結論

1. Vercel 的 Deployment Blocked 錯誤根因通常是 Login Connections 未正確綁定 GitHub 帳號，而非 git email 或 team membership 問題。
2. Vercel 辨識 commit author 的四步鏈路：git commit email → GitHub 帳號 → Login Connections 綁定 → Vercel team membership，第三步最容易被忽略。
3. 「用 GitHub 登入 Vercel」和「在 Vercel 帳號的 Login Connections 綁定 GitHub」看起來像同一件事，但 Vercel 內部處理可能不同。

關鍵證據

• 被 block 的 deployment 無法 redeploy，必須推新 commit。
• Hobby plan 不支援 private repo 的多人協作，只有 owner 能觸發部署。
• 排查花了約一小時，經歷了修 email、確認 membership、redeploy、推空 commit 四次失敗嘗試。

質疑

依賴哪些前提假設？

• 假設使用 GitHub 作為 git provider（Vercel 也支援 GitLab、Bitbucket）。
• 假設使用 Pro plan 以上，Hobby plan 的限制更多。
• 假設團隊成員有意願在 Vercel 上管理自己的帳號設定。

換產業/規模/技術棧還成立嗎？

• Login Connections 問題是 Vercel 特有的，但「帳號綁定不正確導致權限異常」的模式在各平台都存在。
• [[Cloudflare Pages]] 的協作模式不同，不依賴 commit author 辨識。
• 大型團隊使用 Vercel 時，onboarding 流程應包含 Login Connections 的檢查步驟。

反例或邊界條件

• 如果同事只需要偶爾推一次 code，走完 Vercel 設定流程的成本可能過高。
• CI/CD 用 service account 推送時，也需要對應的 Vercel 帳號設定。

對標

其他領域的類似現象

• 機場安檢的身份比對：護照（git email）→ 簽證（GitHub 帳號）→ 入境許可（Login Connections）→ 登機（team member），任何一環斷裂都會被擋。
• SSO 系統的帳號綁定：企業 SSO 中常見「登入成功但權限不足」的問題，根因類似。

知識可遷移到哪些場景

• 任何涉及多平台帳號綁定的 [[除錯排查方法論]]。
• 團隊 onboarding 清單的設計：將隱性設定（如 Login Connections）列為必做項目。

關聯概念

• [[除錯排查方法論]]
• [[部署平台帳號綁定]]
• [[分支部署策略]]
• [[Vercel]]