VSCode中dbt连接BigQuery遇凭证错误，如何排查配置问题？

我正尝试在VSCode中配置dbt连接BigQuery，已将BigQuery密钥文件json放置在dbt项目根目录，并创建了如下profiles.yml配置文件：

my-bigquery-db:
  target: dev
  outputs:
    dev:
      type: bigquery
      method: service-account
      project: civil-parsec-350114
      dataset: dbt_dataset
      threads: 1
      keyfile: bigquery.json

运行时出现如下错误：

dbt encountered an error while trying to read your profiles.yml file.

Could not automatically determine credentials. Please set GOOGLE_APPLICATION_CREDENTIALS or explicitly create credentials and re-run the application. For more information, please see https://cloud.google.com/docs/authentication/getting-started

即使使用空的profiles.yml文件也会出现相同错误，我怀疑profiles.yml文件未被加载，请问该如何调试？可能的问题有哪些？

一、确认profiles.yml的加载路径 #

dbt默认不会读取项目根目录的profiles.yml，它的默认路径是：

• macOS/Linux: ~/.dbt/profiles.yml
• Windows: C:\Users\<你的用户名>\.dbt\profiles.yml

调试方法：

• 运行命令 dbt debug --profiles-dir <你放置profiles.yml的目录>，指定配置文件所在目录，验证是否能正常加载
• 执行 dbt debug 不带参数，查看输出中"Profile directory"字段，确认是否和你存放文件的目录一致

二、检查配置文件格式问题 #

YAML格式错误会导致dbt无法解析配置，进而触发认证类错误：

• 缩进要求：必须用空格（不能用制表符），每个层级缩进保持统一（比如子项缩进2个空格）
• 密钥路径：keyfile的相对路径是相对于profiles.yml所在目录，而非dbt项目根目录。建议直接使用绝对路径，避免路径解析错误

三、验证认证配置有效性 #

• 设置环境变量GOOGLE_APPLICATION_CREDENTIALS指向密钥文件路径，再运行dbt debug，如果能正常连接，说明密钥文件本身没问题，问题出在profiles.yml的加载或配置上
• 检查密钥文件权限：macOS/Linux系统可执行chmod 600 bigquery.json，确保当前用户有读取权限

四、VSCode环境特殊排查 #

• 验证终端环境变量：在VSCode终端运行echo $GOOGLE_APPLICATION_CREDENTIALS（macOS/Linux）或echo %GOOGLE_APPLICATION_CREDENTIALS%（Windows），确认环境变量是否正常加载
• 检查dbt扩展配置：如果使用VSCode的dbt扩展，需在扩展设置中指定profiles.yml的正确路径

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