dbt Core版本与dbt_utils包不兼容报错求助

排查与修复步骤 #

1. 确认版本匹配关系 #

dbt_utils对dbt Core的版本有严格兼容要求，先检查当前dbt版本：

dbt --version

对照dbt_utils的版本规则（举例）：

• dbt_utils 1.0.x 适配dbt Core 1.0.x-1.6.x
• dbt_utils 0.9.x 适配dbt Core 0.20.x-1.0.x

2. 指定兼容的dbt_utils版本 #

修改你的packages.yml，明确写入与当前dbt Core匹配的版本号，示例：

packages:
  - package: dbt-labs/dbt_utils
    version: "1.0.0" # 替换为对应兼容版本

3. 清理并重新安装依赖 #

先删除旧的依赖包目录：

rm -rf dbt_packages/

再重新执行依赖安装：

dbt deps

4. 验证安装结果 #

检查dbt_utils的实际安装版本是否符合要求：

cat dbt_packages/dbt_utils/dbt_project.yml | grep version

Mac M1额外适配方案 #

若因ARM架构导致安装异常，可尝试：

• 使用Homebrew安装适配ARM的Python环境
• 切换到x86兼容模式执行dbt命令：

arch -x86_64 zsh

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