dbt Core 1.4自定义Schema失效：为何仍检索默认Schema？求解决方案

可能的原因 #

• dbt_project.yml中文件夹层级配置错误：缩进不对、项目名称层级缺失，导致dbt未识别到文件夹的专属Schema配置
• 模型引用硬编码了Schema名称，未使用ref()语法，导致dbt无法自动解析目标Schema
• 自定义generate_schema_name宏逻辑错误，覆盖了文件夹级别的Schema配置
• 缓存未彻底清理，旧的manifest文件导致dbt沿用默认Schema解析

解决步骤 #

1. 校验dbt_project.yml配置格式 #

确保文件夹的Schema配置层级正确，严格对齐缩进，且包含项目名称（即dbt_project.yml中name字段的值）：

models:
  your_project_name:  # 替换为你的项目名称
    marketing:        # 模型所在文件夹名称
      +schema: marketing_schema  # 目标Schema名称
    sales:
      +schema: sales_schema

注意：不要在models根节点直接配置子文件夹，必须嵌套在项目名称节点下；同时避免全局+schema配置覆盖子文件夹设置。

2. 检查模型引用方式 #

所有模型间引用必须使用ref()语法，禁止硬编码Schema：

• 正确写法：select * from {{ ref('customer_model') }}
• 错误写法：select * from dbo.customer_model 或 select * from {{ source('dbo', 'customer_model') }}
  运行dbt compile后，查看target/compiled目录下的SQL文件，确认生成的表名是否带目标Schema，而非默认的dbo。

3. 修复自定义generate_schema_name宏 #

如果自定义了macros/generate_schema_name.sql，确保逻辑优先使用模型配置的custom_schema_name：

{% macro generate_schema_name(custom_schema_name, node) -%}
    {%- set default_schema = target.schema -%}
    {%- if custom_schema_name is not none -%}
        {{ custom_schema_name | trim }}
    {%- else -%}
        {{ default_schema }}
    {%- endif -%}
{%- endmacro %}

若宏逻辑忽略了custom_schema_name，会直接返回默认Schema，导致文件夹配置失效。

4. 彻底清理缓存 #

除了使用dbt run --no-partial-parse，手动删除target目录彻底清除缓存：

• Linux/Mac：rm -rf target
• Windows：rmdir /s target
  删除后重新运行dbt，避免旧manifest文件干扰。

5. 验证配置生效 #

• 运行dbt list --select marketing.*（替换为你的文件夹名），查看输出的模型是否显示为[目标Schema].[模型名]
• 运行dbt run --select [文件夹名].[模型名]，查看日志中的SQL语句，确认操作的是目标Schema下的表

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