Next.js项目Vercel新分支部署遇权限问题，授权后仍反复失败

问题背景 #

• 基于Next.js开发项目，代码托管在公司GitHub私有仓库，本人以协作者身份拥有仓库访问权限
• 项目已关联公司Vercel账号，此前分支部署、变更查看均正常
• 近期创建新分支时触发Vercel报错：Git author must have access to the project on Vercel to create deployments
• 昨日重新完成GitHub到Vercel的授权后，新分支部署成功；今日再次尝试部署失败，无法合并新功能

排查与解决步骤 #

1. 确认个人Vercel账号已加入公司项目团队
   登录你的Vercel账号，检查是否被添加到对应项目的团队成员中。仅拥有GitHub仓库协作者权限但未加入Vercel项目团队，会触发权限校验失败。联系公司Vercel管理员，将你的账号添加到项目成员列表，分配至少Developer权限。

2. 重新完成GitHub与Vercel的仓库关联
   不要仅刷新授权，按完整流程操作：

   • 登录公司Vercel账号，进入项目设置 → Git 页面
   • 点击Disconnect解除当前仓库关联
   • 重新点击Connect Git Repository，选择目标私有仓库，授权时确保勾选仓库的分支读写、webhook权限
   • 关联完成后手动触发一次分支部署测试

3. 匹配Git提交作者与Vercel登录邮箱
   Vercel会校验提交作者的身份，若本地Git提交邮箱与Vercel登录邮箱不一致，也会触发报错。执行以下命令检查并修改：

   # 查看当前Git作者信息
   git config user.name
   git config user.email
   # 修改为Vercel登录邮箱对应的信息
   git config --global user.name "你的姓名"
   git config --global user.email "你的Vercel登录邮箱"
   

   修改后，用git commit --amend --reset-author修正最近一次提交的作者信息，再推送代码尝试部署。

4. 检查Vercel团队的Git集成权限
   若公司使用Vercel团队版，进入团队设置 → Git Integration，确认是否开启了允许外部协作者部署分支的选项。部分团队会限制仅内部成员可触发部署，即便拥有GitHub仓库权限也无法绕过。

5. 紧急合并临时方案
   若需快速合并功能，可让公司Vercel团队成员推送你的分支代码，或发起PR后由团队成员手动触发Vercel部署。

内容的提问来源于stack exchange，提问作者Atticus