Fluent NHibernate映射Where子查询自动加别名导致查询不生效

问题表现 #

在ClassMap<T>的Where()方法中配置带子查询的原生过滤条件时，框架会自动为子查询内未显式指定别名的字段追加外层主表别名，导致生成的SQL字段引用错误，查询逻辑不符合预期。

问题复现代码 #

实体映射配置：

public class ExpedienteNnaMap : ClassMap<ExpedienteNna>
{
    public ExpedienteNnaMap()
    {
        Table("personasexpediente");
        Id(x => x.Id, "gidexpediente");
        Map(x => x.FechaCreacion, "fecha");
        References(x => x.DetalleNna, "gidpersona").Not.LazyLoad();
        HasOne(x => x.CondicionMedica).ForeignKey("numero_expediente").Not.LazyLoad();
        Where("expnna = 'nna' AND gidexpediente in (select numero_instrumento from seguimiento s where idcustodio = '23')");
    }
}

框架自动生成的错误SQL：

select
    expediente0_.gidexpediente as gidexpediente1_9_,
    expediente0_.fecha as fecha2_9_,
    expediente0_.gidpersona as gidpersona3_9_
from
    personasexpediente expediente0_
where
( 
    expediente0_.expnna = 'nna'
    and expediente0_.gidexpediente in 
    (
        select
            -- 错误：子查询字段被追加外层表别名
            expediente0_.numero_instrumento
        from
            seguimiento s
        where
            -- 错误：子查询条件字段被追加外层表别名
            expediente0_.idcustodio = '23'
    )
)

根因说明 #

Where()方法的设计逻辑是将传入的SQL片段作为主表的原生过滤条件，框架解析片段时，会默认所有未显式绑定表别名的字段都属于当前映射的主表，自动为其追加主表别名；解析过程不会识别子查询边界，因此子查询内未加别名的字段也会被误判为主表字段，追加错误的别名。

解决方案 #

方案1：子查询字段显式指定表别名（推荐，改动最小） #

给子查询内的所有字段显式加上子查询表的自定义别名，框架识别到字段已经绑定表别名后，就不会再自动追加外层主表别名。
仅需修改Where()内的条件即可，其他映射配置无需调整：

// 子查询内的字段全部显式指定归属表别名s
Where("expnna = 'nna' AND gidexpediente in (select s.numero_instrumento from seguimiento s where s.idcustodio = '23')");

修改后生成的SQL会完全符合预期，子查询字段会保留s.前缀，不会被错误替换为外层表别名，该方案兼容所有NHibernate 3+版本，无额外依赖。

方案2：使用NHibernate过滤器实现复杂过滤逻辑 #

如果过滤条件后续需要动态传参、或包含多层嵌套子查询，可将硬编码在Where()中的逻辑迁移到NHibernate过滤器中实现，过滤器的条件片段不会触发自动别名追加逻辑：

1. 定义过滤器

public class CustodioExpedienteFilter : FilterDefinition
{
    public CustodioExpedienteFilter()
    {
        WithName("CustodioExpedienteFilter");
        // 固定过滤条件直接写在WithCondition中，需要动态传参可通过AddParameter配置参数类型
        WithCondition("expnna = 'nna' AND gidexpediente in (select numero_instrumento from seguimiento s where idcustodio = '23')");
    }
}

2. 在实体映射类中应用过滤器，替换原有Where()配置

public class ExpedienteNnaMap : ClassMap<ExpedienteNna>
{
    public ExpedienteNnaMap()
    {
        Table("personasexpediente");
        Id(x => x.Id, "gidexpediente");
        Map(x => x.FechaCreacion, "fecha");
        References(x => x.DetalleNna, "gidpersona").Not.LazyLoad();
        HasOne(x => x.CondicionMedica).ForeignKey("numero_expediente").Not.LazyLoad();
        // 应用过滤器替代原Where配置
        ApplyFilter<CustodioExpedienteFilter>();
    }
}

3. 查询前启用过滤器即可生效

using var session = sessionFactory.OpenSession();
// 启用过滤器
session.EnableFilter("CustodioExpedienteFilter");
// 查询会自动携带过滤条件，子查询别名不会被篡改
var queryResult = session.Query<ExpedienteNna>().ToList();

注意：不要通过加特殊转义字符、注释片段的方式绕过别名解析，这类黑科技在不同NHibernate版本下兼容性极差，版本升级后极易失效。

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