更新现有记录时遭遇NHibernate NonUniqueObjectException异常

这个坑我之前踩过！当你从视图加载实体后调用通用Update方法抛出这个异常，核心原因是NHibernate的Session中已经存在一个拥有相同ID的对象实例，而你现在要更新的是从视图加载的另一个实例——NHibernate无法确定该同步哪一个到数据库，所以直接抛出了冲突异常。

下面是我总结的几个有效解决方案，按推荐优先级排序：

1. 用Merge替代直接Update（最推荐） #

Session.Update()只适用于你确定Session中没有相同ID实例的场景，而Session.Merge()会自动处理冲突：如果Session里已有相同ID的实例，它会把你传入对象的属性值复制到那个托管实例上，再执行更新；如果没有，就把传入对象附加到Session后更新。

修改你的通用仓储Update方法：

public T Update(T entity)
{
    using (var session = SessionFactory.OpenSession())
    {
        using (var transaction = session.BeginTransaction())
        {
            // 用Merge代替Update
            var mergedEntity = session.Merge(entity);
            transaction.Commit();
            // 注意：返回的mergedEntity是Session托管的实例，后续操作优先用它
            return mergedEntity;
        }
    }
}

2. 清除Session中已存在的冲突实例（谨慎使用） #

如果你明确知道Session中已有的相同ID实例没有未提交的变更，且不需要保留它，可以在更新前把它从Session中移除：

public T Update(T entity)
{
    using (var session = SessionFactory.OpenSession())
    {
        using (var transaction = session.BeginTransaction())
        {
            var existingEntity = session.Get<T>(entity.Id);
            if (existingEntity != null)
            {
                // 从Session中清除已有实例，避免冲突
                session.Evict(existingEntity);
            }
            session.Update(entity);
            transaction.Commit();
            return entity;
        }
    }
}

⚠️ 注意：如果已有实例存在未提交的修改，Evict会直接丢失这些变更，所以只适合你确定已有实例无用的场景。

3. 检查视图的ID唯一性和映射配置 #

虽然你说能正常获取数据，但还是要确认：

• 视图返回的每条记录的主键ID是唯一的（视图SQL可能因为关联逻辑导致重复ID）
• NHibernate实体映射文件中，ID字段的配置和视图返回的主键列完全匹配

如果视图返回重复ID，NHibernate加载时会创建多个相同ID的实例，后续更新必然触发冲突。

4. 用Session.Load获取代理对象（特定场景适用） #

如果你不需要立即加载实体的所有属性，只是要更新部分字段，可以用Session.Load<T>(entity.Id)获取一个代理对象——它不会立即从视图加载数据，只是创建一个托管的代理，这样就不会和Session中已有的实例冲突：

public void UpdatePartial(Guid entityId, Action<T> updateAction)
{
    using (var session = SessionFactory.OpenSession())
    {
        using (var transaction = session.BeginTransaction())
        {
            var proxy = session.Load<T>(entityId);
            updateAction(proxy);
            transaction.Commit();
        }
    }
}

这个方法适合只更新部分属性的场景，避免加载整个实体带来的冲突。

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