配置Firebase App Distribution部署安卓应用遇权限及角色缺失问题

一、确认角色查找的正确路径 #

• 打开Google Cloud控制台并进入目标项目
• 导航至IAM与管理员 > IAM页面
• 点击顶部「添加」按钮，在「角色」搜索框中输入完整名称Firebase App Distribution Admin；若直接搜不到，尝试输入关键词Firebase App Distribution，从下拉结果中筛选对应角色
• 注意：若项目为新创建，需先在Google Cloud控制台的API库中搜索启用Firebase App Distribution API，角色才会显示在可选列表中

二、修正服务账号配置逻辑 #

• 区分「角色」和「服务账号」：Firebase App Distribution Admin SDK Service agent是一个系统服务账号，而你需要的是给当前调用部署的账号分配Firebase App Distribution Admin角色，而非添加这个系统服务账号
• 若使用CI/CD工具（如GitHub Actions、GitLab CI）：
  • 确认部署所用的是自定义服务账号还是Firebase默认服务账号
  • 自定义服务账号：直接为其分配Firebase App Distribution Admin角色
  • Firebase默认服务账号（格式为firebase-adminsdk-xxx@[项目ID].iam.gserviceaccount.com）：检查它是否已拥有该角色，若无则补充分配

三、验证权限与部署流程 #

• 分配角色后等待1-2分钟，让Google Cloud权限同步（权限生效存在延迟）
• 重新运行部署命令，若使用Firebase CLI，确保用正确的服务账号密钥登录：

  firebase login:ci --token [你的服务账号密钥]
  

• 顺带确认APK文件完整性，排除文件损坏导致的上传异常干扰

四、临时排查方案（最小权限原则后续调整） #

• 若仍找不到目标角色，可临时给服务账号分配Firebase Admin角色（高权限角色，测试完成后务必换回最小权限），验证是否能正常上传，以此确认问题根源是否为角色缺失
• 尝试清除角色搜索框内容，滚动查看所有Firebase相关角色，避免搜索过滤导致角色被隐藏

内容的提问来源于stack exchange，提问作者Ángel Gómez García