Python访问BigQuery遇ReauthFailError：执行gcloud auth login仍报错

问题原因 #

• gcloud auth login生成的是交互式会话凭据，这类凭据在非交互式环境（后台脚本、CI/CD流水线、无终端交互的远程服务器）中触发重认证时，因缺少交互界面导致失败。
• 现有凭据已过期，系统自动尝试重认证但无交互环境支持。

解决方法 #

方法1：使用服务账号密钥文件（推荐用于生产/非交互式环境）

这是最稳定的非交互式访问方式，适用于脚本、服务等场景：

1. 在Google Cloud控制台的IAM与管理>服务账号页面，创建或选择一个拥有BigQuery访问权限的服务账号。
2. 点击「添加密钥」>「创建新密钥」，选择JSON格式下载密钥文件到本地/服务器。
3. 在Python代码中指定密钥文件路径：

from google.cloud import bigquery

client = bigquery.Client.from_service_account_json("/绝对路径/到/服务账号密钥.json")

或者通过环境变量指定（避免硬编码路径）：

export GOOGLE_APPLICATION_CREDENTIALS="/绝对路径/到/服务账号密钥.json"

之后直接初始化客户端即可：

from google.cloud import bigquery

client = bigquery.Client()

方法2：生成应用默认凭据（适用于个人非交互式测试）

如果是个人测试场景，可生成无需交互重认证的应用默认凭据：

• 在终端执行命令（无GUI环境下适用）：

gcloud auth application-default login --no-launch-browser

• 终端会输出一个授权链接，复制到本地浏览器打开完成认证，再将返回的授权码粘贴回终端即可生成有效凭据。
• 这类凭据有效期约30天，到期后需重新执行该命令更新。

方法3：修复现有交互式凭据

如果必须使用用户账号凭据：

• 执行gcloud auth print-access-token验证当前凭据是否有效，若返回错误则说明凭据已过期。
• 在交互式终端（本地带GUI的终端，或通过ssh -X开启图形转发的远程终端）中重新执行gcloud auth login，确保能弹出浏览器完成完整认证流程。

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