You need to enable JavaScript to run this app. Python3.7调用Google Secret Manager报403权限错误但gcloud命令行正常
优惠活动
大模型
产品
解决方案
定价
更多

Python3.7调用Google Secret Manager报403权限错误但gcloud命令行正常

GCP Secret Manager Python调用403权限异常排查

由于你用gcloud secrets list可以正常访问,说明项目内的Secret Manager服务本身是开通正常的、网络链路也没有拦截,问题基本都出在Python客户端侧的认证、配置不匹配环节,按出现概率从高到低列具体原因:

  • Python客户端实际使用的认证身份,和gcloud CLI的认证身份不匹配
    gcloud CLI的访问凭证是独立存储的,不会自动同步给Python端的Google Cloud客户端。Python客户端会按照固定的应用默认凭证检索顺序查找可用凭证,很容易读到无效凭证:
    • 环境变量GOOGLE_APPLICATION_CREDENTIALS指向了其他项目的服务账号密钥,该服务账号不在你目标项目的IAM成员列表中,没有Secret Manager访问权限
    • 本地残留的旧ADC凭证,对应账号已经被移除项目权限
    • 服务器部署场景下,读取到运行环境内置的默认服务账号,该账号未被授予Secret Manager相关角色
      验证方法很直接:在代码中调用google.auth.default()获取当前凭证的关联邮箱,和你在GCP IAM面板里绑定了权限的账号逐一比对,身份不匹配必然触发403。
  • IAM权限的绑定层级不符合list操作的要求
    报错涉及的权限是secretmanager.secrets.list,这个权限仅能在项目级、文件夹级或组织级资源上授予。如果之前配置权限时,只在单个Secret资源的详情页给账号绑定了Secret Manager角色,是不会覆盖list操作权限的——单Secret层级的权限仅支持读取对应Secret的具体值,根本不支持列出项目下所有Secret的操作,自然会被拦截。
    需要确认:你的使用账号/服务账号,是在项目级资源上被授予了roles/secretmanager.viewer及以上角色,而不是只在单Secret资源上绑定了权限。
  • Python 3.7环境下的客户端版本兼容问题
    适配Python 3.7的早期版本google-cloud-secret-manager客户端(2.10.0之前的版本)存在已知的认证链读取异常bug,会跳过本地已配置的ADC凭证,使用无效的匿名凭证发起请求,哪怕所有权限配置完全正确也会返回403。适配Python 3.7的最后一个稳定客户端版本为google-cloud-secret-manager==2.16.3,可以优先核对当前环境的安装版本。
  • 项目ID填写错误
    如果代码里拼接的parent路径中的项目ID,和实际有权限的项目不一致——比如把项目编号当成项目ID填写、或者拼写错误——GCP为了防止恶意项目枚举,对无权限访问或不存在的项目ID,会返回和权限不足完全一致的403报错(即带"or it may not exist"后缀的提示),不会明确告知你项目不存在。

快速排障操作步骤

  • 在Python运行的本地/服务器环境中,执行gcloud auth application-default login,将本地ADC凭证同步为当前gcloud登录的、有正常权限的账号,再重新运行Python代码
  • 核对代码中拼接的项目ID,和终端执行gcloud config get-value project返回的当前活动项目ID完全一致
  • 确认项目级IAM策略中,你使用的账号/服务账号已被授予包含secretmanager.secrets.list权限的角色

内容的提问来源于stack exchange,提问作者blob

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 03:36:04