Firebase Hosting API创建站点返回401错误排查求助

问题概述 #

• 在Google官方文档的API测试工具中可成功创建Firebase托管站点
• 代码调用GET站点列表API正常返回200及站点数据
• 调用POST创建站点API时返回无错误说明的401；传入空SITE对象返回400
• 请求URL存在格式错误（原URL混淆了权限范围标识与API端点路径）
• 权限范围使用https://www.googleapis.com/auth/firebase.hosting（与GET请求一致）
• 请求头已携带Authorization: Bearer ${token}格式的Token
• 更换新API Key后无改善，GET请求新旧Key均正常

排查思路与解决建议 #

1. 修正API请求URL #

这是最可能导致401的核心问题：你提供的URL混淆了权限范围标识与API端点路径，正确的创建站点API端点应为：

POST https://firebasehosting.googleapis.com/v1/projects/{你的项目ID}/sites?siteId=idOfNewSite

原URL中的auth/firebase.hosting是权限范围的字符串，并非API路径的一部分，必须修正为官方指定的端点。

2. 校验Token的有效性与权限 #

• 解码Token（可使用本地JWT解码工具）确认：
  • exp字段未过期
  • scope字段包含https://www.googleapis.com/auth/firebase.hosting或更宽泛的https://www.googleapis.com/auth/cloud-platform（Firebase依赖GCP权限）
• 进入GCP IAM控制台，检查Token对应的账号是否被授予Firebase Hosting Admin或Editor角色，仅拥有Viewer权限无法创建站点。

3. 规范请求体格式 #

400错误说明请求体不符合API要求，创建站点的请求体至少需指定站点类型，示例：

{
  "type": "DEFAULT"
}

type可选值为DEFAULT（常规托管站点）或APP（关联Firebase App的站点），不可传入空对象。

4. 区分API Key与OAuth 2.0 Token的使用场景 #

• API Key仅适用于部分只读公开API，Firebase Hosting的写操作（如创建站点）必须使用OAuth 2.0 Bearer Token，不可用API Key替代。确认代码中未误将API Key放入Authorization头中。
• 确保Token通过合法流程获取：如服务账号密钥生成、OAuth 2.0授权码流程，避免使用无效或权限不足的Token。

5. 验证站点ID与项目ID合法性 #

• 项目ID必须是GCP/Firebase项目的真实ID（非项目显示名称）
• 站点ID需符合规则：仅包含小写字母、数字、连字符，不能以连字符开头/结尾，长度1-63字符。

6. 检查Firebase Hosting API启用状态 #

进入GCP控制台API库，确认Firebase Hosting API已启用（虽GET请求正常，但存在权限同步延迟的可能）。

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