使用Github Action通过Firebase CLI部署时遇Auth同步错误求助

问题背景 #

通过Github Action使用服务账号，配合Firebase CLI执行部署操作，服务账号已配置以下角色：

• roles/cloudfunctions.admin
• roles/firebase.sdkAdminServiceAgent
• roles/firebaseauth.admin
• roles/iam.serviceAccountTokenCreator
• roles/storage.admin

部署过程中出现如下警告：

⚠ hosting:channel: 无法将渠道域名添加到Firebase Auth。请访问Firebase控制台对应项目的Auth提供者页面
⚠ hosting:channel: 无法同步Firebase Auth状态。

问题分析 #

这些警告源于Firebase Hosting临时预览渠道需要将自身域名加入Firebase Auth的授权域名列表，但当前服务账号无法自动完成该操作，可能的原因包括：

1. 项目中Firebase Auth服务尚未启用，或未完成初始配置（未启用任何登录提供者）
2. 服务账号的roles/firebaseauth.admin权限未正确生效，或存在权限继承延迟
3. Auth的授权域名列表需要手动确认配置规则

解决方案 #

1. 确认Auth服务状态：登录Firebase控制台进入对应项目的Auth提供者页面，确保Auth服务已启用，且至少配置了一个登录提供者（哪怕是匿名登录）。
2. 手动添加渠道域名：找到Hosting渠道的域名（格式通常为[渠道ID]-[项目ID].web.app或自定义域名），在Auth控制台的「授权域名」板块将其添加进去。
3. 验证服务账号权限：在Google Cloud IAM页面检查服务账号的角色分配，确认roles/firebaseauth.admin已正确绑定，且无权限生效延迟问题。
4. 重新执行部署：完成上述配置后，重新触发Github Action部署流程，警告应会消失。

为什么指向Auth提供者页面？ #

该页面是项目的Firebase Auth核心配置入口，原因如下：

• Hosting渠道域名必须加入Auth授权域名列表，否则用户通过该渠道访问时，Auth相关功能（如登录）会被浏览器安全策略或Firebase Auth规则拦截。
• 如果Auth服务未启用或未完成初始配置（无可用登录提供者），Firebase CLI无法通过服务账号自动完成域名添加，必须手动进入控制台完成配置初始化。

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