调用GCP /compute/v1/projects/{project}/zones接口返回401错误排查

问题根因及解决方案 #

• 首先检查Compute Engine接口的请求URL是否正确：/zones/list 不是顶层接口路径，完整合法路径应为 https://compute.googleapis.com/compute/v1/projects/{实际项目ID}/zones，如果漏写项目ID、用错服务域名，GCP会返回误导性的401报错而非路径错误提示，这是高频触发该问题的原因。
• 检查X-Goog-User-Project头的取值：该头仅用于指定配额计费的关联项目，调用自身项目下的Compute资源时，如果头中填写的项目ID和URL路径中的项目ID不一致，会直接触发鉴权校验失败，你可以先移除该头再重试。
• 确认身份权限匹配：你获取的令牌作用域合法不代表对应身份（用户账号/服务账号）有目标项目的Compute资源访问权限，projects.list接口仅需要资源管理器的只读权限，和Compute接口的权限是独立的，需要确保对应身份在目标项目的IAM配置中绑定了至少Compute Viewer及以上权限。
• 修正不规范的HTTP头配置：你当前把charset: utf-8单独作为请求头不符合HTTP规范，正确写法是合并到Content-Type头中：Content-Type: application/json; charset=utf-8，部分严格的GCP接口会识别到异常头后忽略后续的Authorization头，导致令牌未被正常读取。

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