NHibernate核心库中SessionFactory线程安全问题的分析与解决方案

背景介绍

在NHibernate核心库中，SessionFactoryObjectFactory作为ISessionFactory的查找和反序列化工具，长期以来被开发者用于管理会话工厂实例。然而，在多线程环境下使用该组件时，可能会遇到会话工厂部分构建的问题，导致难以调试的线程安全问题。

问题本质

问题的核心在于SessionFactoryObjectFactory在ISessionFactory构建过程的早期就将实例注册到缓存中。此时如果其他线程尝试获取该实例，可能会得到一个尚未完全构建完成的ISessionFactory对象。这种情况会导致：

1. 线程A正在构建ISessionFactory
2. 构建过程中，实例被注册到缓存
3. 线程B从缓存获取该实例时，部分字典（如entityPersisters）可能尚未完全初始化
4. 线程B尝试使用不完整的ISessionFactory，导致未定义行为

技术细节分析

ISessionFactory的构建过程包含多个关键步骤：

• 实体持久化器初始化
• 类元数据字典填充
• 数据库模式管理
• 会话上下文创建
• 查询缓存设置
• 实体未找到回调配置

在旧版实现中，即使SessionFactoryObjectFactory在构建后期注册实例，仍然存在类似问题，因为构建过程本身就不是原子操作。

解决方案演进

NHibernate团队针对此问题提供了两种解决方案：

1. GetOrBuild方法：新增的线程安全构建方法，确保：

   • 同一名称的ISessionFactory只会构建一次
   • 调用者永远不会获取到未完全构建的实例
   • 内部采用适当的同步机制

2. 内部结构优化：将ISessionFactory中的可变字典改为只读字典，确保：

   • 构建完成后字典内容不可变
   • 消除构建过程中并发访问导致的数据不一致风险
   • 提高整体线程安全性

最佳实践建议

对于需要使用多ISessionFactory的场景（如多租户系统），建议：

1. 统一使用GetOrBuild方法创建实例
2. 避免混合使用直接构建和缓存查找
3. 对于高级场景，考虑实现自定义的会话工厂缓存
4. 注意二级缓存和查询缓存在多租户环境中的隔离问题

技术启示

这个问题反映了分布式系统开发中的一个重要原则：共享可变状态的复杂性。NHibernate的解决方案展示了如何通过：

• 提供原子性操作接口
• 减少可变状态
• 明确组件职责边界 来构建更可靠的系统。

开发者应当注意，即使是被广泛使用的框架组件，也可能存在特定的使用约束和边界条件，深入理解其设计意图和实现细节对于构建稳定系统至关重要。