Google API测试环境变量设置引发认证失败问题

看起来你遇到了环境变量传递和凭据加载的典型坑，我之前也踩过类似的坑，给你几个针对性的解决思路：

1. 先排查环境变量的传递问题 #

单独设置环境变量能跑，但和测试代码结合就失效，大概率是环境变量没正确传递到Google API的执行上下文：

• 如果是bash脚本：别只写GOOGLE_APPLICATION_CREDENTIALS="/path/to/cred.json"，一定要加export，而且要放在测试代码执行的前面，且不要在子shell（比如括号、管道里）设置：

  # 正确姿势：在主shell中导出变量
  export GOOGLE_APPLICATION_CREDENTIALS="/absolute/path/to/your/service-account.json"
  # 紧接着执行测试代码
  python your-google-test-script.py
  

• 如果是Python脚本内设置环境变量：要注意先设置变量，再导入Google API相关模块——因为很多Google客户端模块会在初始化时读取环境变量，提前导入的话会读取旧的空值：

  import os
  # 先设置环境变量
  os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = '/absolute/path/to/cred.json'
  # 再导入API模块
  from google.cloud import storage
  # 后续执行测试逻辑
  client = storage.Client()
  

2. 解决JSON凭据文件失效的问题 #

先跳过环境变量，直接验证文件本身是否可用：

• 用绝对路径！相对路径很容易因为脚本执行的工作目录不同导致找不到文件
• 检查文件权限：确保运行脚本的用户有读取权限，用ls -l /path/to/cred.json查看，至少要有r权限
• 加一段简单的读取测试代码，确认文件能被正常解析：

  import json
  try:
      with open('/absolute/path/to/cred.json', 'r') as f:
          cred_data = json.load(f)
      print(f"✅ 成功读取凭据，项目ID：{cred_data.get('project_id')}")
  except Exception as e:
      print(f"❌ 读取凭据失败：{str(e)}")
  

如果这段代码报错，先解决路径/权限问题；如果能正常输出，那问题就出在Google API客户端没正确读取环境变量，直接用下面的方案更可靠。

3. 更稳妥的方案：直接在代码中加载凭据 #

绕开环境变量，显式在代码中指定凭据文件，完全避免环境传递的问题：

from google.oauth2 import service_account
from google.cloud import your_target_service

# 直接加载凭据文件
creds = service_account.Credentials.from_service_account_file(
    '/absolute/path/to/cred.json'
)
# 初始化客户端时传入凭据
client = your_target_service.Client(credentials=creds)
# 执行测试逻辑

这种方式不仅更可靠，也让脚本的依赖关系更清晰，不用依赖外部环境配置。

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