DBT Core执行dbt debug时profiles.yml存在却提示未找到求助

问题 #

VSCode开发DBT项目时，执行dbt debug命令始终提示profiles.yml文件未找到，但该文件实际存在于users/<my_user_id>/.dbt目录中。报错信息如下：

Configuration:
23:33:02 profiles.yml file [ERROR not found]
23:33:02 dbt_project.yml file [OK found and valid]
23:33:02 Required dependencies:
23:33:02 - git [OK found]

Connection test skipped since no profile was found
23:11:50 1 check failed:
23:11:50 dbt looked for a profiles.yml file in ~/.dbt/profiles.yml, but did not find one.

解决方案 #

1. 确认~的实际指向 #

dbt默认读取~/.dbt/profiles.yml，但~的指向因终端环境而异：

• Windows CMD中~不指向用户目录，需替换为绝对路径C:\Users\<my_user_id>\.dbt\profiles.yml
• 在Linux/macOS/PowerShell中执行echo ~，确认输出路径与你的文件存放目录完全一致

2. 修复文件权限 #

确保当前运行dbt的用户拥有profiles.yml的读取权限：

• Linux/macOS：运行命令chmod +r ~/.dbt/profiles.yml
• Windows：右键文件→属性→安全，确认当前用户已勾选读取权限

3. 手动指定profiles目录 #

直接通过命令或环境变量指定文件路径，绕过默认路径检测：

命令行直接指定

dbt debug --profiles-dir /users/<my_user_id>/.dbt

通过环境变量设置

• Linux/macOS：

export DBT_PROFILES_DIR=/users/<my_user_id>/.dbt
dbt debug

• Windows CMD：

set DBT_PROFILES_DIR=C:\Users\<my_user_id>\.dbt
dbt debug

• Windows PowerShell：

$env:DBT_PROFILES_DIR = "C:\Users\<my_user_id>\.dbt"
dbt debug

4. 校验YAML文件格式 #

profiles.yml的语法错误也会导致dbt无法识别文件：

• 检查缩进：YAML要求严格使用2个空格缩进，避免用Tab
• 确认冒号后有空格：如my_profile:而非my_profile:
• 可用yamllint ~/.dbt/profiles.yml（需先安装yamllint工具）校验语法

5. 检查VSCode终端环境 #

• 若使用WSL开发，文件需存放在WSL的用户目录内，而非Windows本地目录
• 若使用远程容器开发，需确保profiles.yml已正确挂载到容器内的对应路径

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