NHibernate代码映射OneToOne时如何直接获取关联Person的Name值

• 核心结论：NHibernate 原生的OneToOne映射是用于配置实体间的关联关系，不支持直接将关联实体的子属性扁平化映射为当前实体的标量属性（如你需要的string类型Name）。你当前代码中使用的PropertyReference方法，作用是指定关联实体端用于匹配外键关联的属性，并非用来读取关联实体的子属性值，无法实现你要的效果。

你当前直接将string类型的Name属性配置为OneToOne关联本身存在类型不匹配问题，会导致NHibernate生成错误的关联查询SQL，无法正常运行。

最优实现方案（无需修改现有Name属性调用逻辑） #

不需要自定义复杂的映射扩展，仅需调整实体结构和映射规则即可，所有原有对Name属性的调用代码完全不用改动：

1. 在实体类中新增Person类型的导航属性，用于配置真正的一对一关联：

// 用于配置OneToOne映射的导航属性
public virtual Person Person { get; set; }

2. 保留原有string类型的Name属性，将其改为非映射的兼容属性，内部逻辑直接关联Person导航属性的Name字段：

// 原有属性完全保留，老代码调用逻辑无需任何修改
public virtual string Name
{
    get => Person?.Name;
    set
    {
        // 如果业务中存在给Name赋值的场景，保留以下逻辑；无赋值场景可直接删除set块
        if (Person == null) Person = new Person();
        Person.Name = value;
    }
}

3. 调整映射配置，将OneToOne关联绑定到Person类型的导航属性上，同时标记Name属性不参与数据库映射：

OneToOne(x => x.Person, mapper =>
{
    mapper.Cascade(Cascade.All);
    // 可按需添加其他关联配置，比如懒加载、外键约束、可空性配置等
});

// 在当前实体的类映射配置中添加忽略规则
Class<YourEntity>(m =>
{
    m.Property(x => x.Name, p => p.Ignore());
});

其他方案说明 #

如果一定要在纯映射层实现该逻辑而不写兼容属性，需要自行实现NHibernate的自定义IUserType或IPropertyAccessor接口完成属性值的投影获取，开发和后续维护成本极高，没有实际落地价值。

内容的提问来源于stack exchange，提问作者Staša Sekulić