NHibernate可空外键关联查询方法及property-ref映射异常说明

NHibernate 5.2.4及以上版本对property-ref映射逻辑做了调整：

• 使用property-ref映射的集合，当被引用属性为null时不再返回空集合，会直接抛出异常。

你使用HasMany(m => m.SomeChildrenList).PropertyRef("Property");映射时触发异常，正是因为数据库中对应的Property字段允许为空。

可通过以下三种方案实现可空外键的关联查询：

方案1：集合映射增加空值过滤 #

在集合映射规则中显式过滤外键为空的记录，绕开空值校验规则：

HasMany(m => m.SomeChildrenList)
    .PropertyRef("Property")
    .Where("Property IS NOT NULL");

该方案无需修改业务代码，仅调整映射规则即可兼容原有调用逻辑。

方案2：手动写关联查询替代全局映射 #

如果不需要全局定义关联关系，可在业务查询时通过LINQ或QueryOver手动实现关联逻辑，灵活处理空值场景：

// LINQ 示例
var queryResult = session.Query<MainEntity>()
    .LeftJoin(
        session.Query<ChildEntity>(),
        main => main.Property,
        child => c.RelatedForeignKey,
        (main, child) => new { MainData = main, ChildData = child }
    )
    .ToList();

该方案灵活度最高，可自定义空外键时的关联返回逻辑。

方案3：业务层手动加载子集合 #

放弃property-ref的全局集合映射，改为在业务逻辑中手动判断加载：

public List<ChildEntity> GetRelatedChildren(MainEntity main)
{
    // 外键为空时直接返回空集合，和老版本逻辑保持一致
    if (main.Property == null) 
        return new List<ChildEntity>();
    return session.Query<ChildEntity>()
        .Where(c => c.RelatedForeignKey == main.Property)
        .ToList();
}

该方案完全避开了NHibernate对property-ref的空值校验，适配所有版本。

内容的提问来源于stack exchange，提问作者Tomas Aušvicas