NHibernate实体继承映射问题解析

问题背景

在使用NHibernate进行实体类继承映射时，开发者vknht遇到了一个典型问题：当查询基类实体时，系统返回了基类和子类的所有实例，而预期应该只返回基类实例。这种情况通常发生在实体继承映射配置不正确的情况下。

问题重现

开发者提供了以下场景：

1. 定义了一个基类FooTableEntity和它的子类FooTableExEntity
2. 使用ClassMap<T>分别映射这两个类到同一个数据库表
3. 执行对基类的查询时，返回了基类和子类的所有实例

根本原因分析

问题的核心在于映射配置错误。开发者使用了两个独立的ClassMap来映射基类和子类，这导致NHibernate将它们视为两个独立的实体，而不是继承关系。正确的做法应该是：

1. 对基类使用ClassMap<T>
2. 对子类使用SubclassMap<T>

正确解决方案

单表继承策略(Table-per-Class Hierarchy)

如果基类和子类共享同一个表(这是开发者最初尝试的方案)，正确的映射应该是：

// 基类映射
public class FooTableMap : ClassMap<FooTableEntity>
{
    public FooTableMap()
    {
        Table("FooTable");
        Id(x => x.Id, "Id");
        // 其他基类属性映射
    }
}

// 子类映射
public class FooTableExMap : SubclassMap<FooTableExEntity>
{
    public FooTableExMap()
    {
        Map(x => x.Name, "Name");
    }
}

注意子类映射中不需要(也不应该)指定Table属性，因为它与基类共享同一个表。

鉴别器字段

在单表继承策略中，通常需要一个鉴别器字段来区分不同的子类。虽然NHibernate可以自动处理，但显式声明更清晰：

public class FooTableMap : ClassMap<FooTableEntity>
{
    public FooTableMap()
    {
        Table("FooTable");
        Id(x => x.Id, "Id");
        DiscriminateSubClassesOnColumn("Type");
        // 其他基类属性映射
    }
}

public class FooTableExMap : SubclassMap<FooTableExEntity>
{
    public FooTableExMap()
    {
        DiscriminatorValue("ExEntity");
        Map(x => x.Name, "Name");
    }
}

其他继承策略

如果开发者希望使用其他继承映射策略，NHibernate也支持：

每个具体类一张表(Table-per-Concrete-Class)

public class FooTableExMap : JoinedSubclassMap<FooTableExEntity>
{
    public FooTableExMap()
    {
        Table("FooTableEx");
        KeyColumn("Id"); // 与基表关联的外键
        Map(x => x.Name, "Name");
    }
}

每个子类一张表(Table-per-Subclass)

public class FooTableExMap : SubclassMap<FooTableExEntity>
{
    public FooTableExMap()
    {
        Table("FooTableEx");
        Map(x => x.Name, "Name");
    }
}

最佳实践建议

1. 明确继承策略：在项目开始时就确定使用哪种继承映射策略
2. 保持一致性：整个项目中最好使用同一种继承策略
3. 性能考虑：单表继承策略查询效率最高，但可能有冗余字段；其他策略需要连接查询
4. 文档记录：在映射类中添加注释说明使用的继承策略

总结

NHibernate的实体继承映射是一个强大但需要谨慎使用的功能。正确配置继承关系可以避免查询结果异常、性能问题等各种潜在问题。开发者应该根据实际业务需求选择合适的继承策略，并确保映射配置正确无误。