NHibernate không chết. Nó cũng không phải lựa chọn cho dự án mới. Đó là trạng thái khó chịu nhưng chính xác của một ORM từng là mặc định trong .NET: vẫn phát hành bản vá, vẫn chạy trên .NET 10, vẫn nằm trong hàng nghìn hệ thống doanh nghiệp, nhưng đã lùi về vai trò bảo trì trong khi EF Core chiếm vị trí mặc định.
Bài này nói rõ NHibernate 5.7.1 đang ở đâu, cách nó hoạt động qua SessionFactory và ISession, mapping nào còn dùng được, cache cấp hai của nó khác EF Core thế nào, và một chiến lược migration không big-bang.
Mục lục
Cập nhật 2026
- NHibernate 5.7.1 là bản mới nhất và có target
net10.0, nên vẫn chạy được trên .NET 10 LTS. Dự án đang ở chế độ maintenance: bản vá và tương thích, không phải làn sóng tính năng mới. - FluentNHibernate 3.5.0 và NHibernate.Mapping.Attributes 5.1.0 vẫn là các cách mapping được dùng;
hbm.xmlvẫn tồn tại trong các hệ thống cũ. - NHibernate có second-level cache tích hợp sẵn, kèm query cache. EF Core 10 vẫn không có L2 native — đây là một trong ít điểm NHibernate còn hơn.
- .NET 8 và .NET 9 hết hỗ trợ ngày 2026-11-10; các hệ thống NHibernate cũng phải lên .NET 10, và đây là thời điểm tốt để đánh giá migration.
NHibernate là gì và trạng thái thật
NHibernate là ORM nguồn mở cho .NET, port từ Hibernate của Java. Nó ánh xạ POCO sang bảng, quản lý quan hệ, cung cấp HQL và LINQ, và cho phép cấu hình mapping rất chi tiết. Trước khi EF Core trưởng thành, đây là ORM nghiêm túc nhất cho ứng dụng .NET lớn, đặc biệt khi schema không được thiết kế cho ORM.
Trạng thái hiện tại cần nói thẳng: ổn định, được bảo trì, nhưng không phải hướng đầu tư cho dự án mới. Không có migration tự động như EF Core, không có hệ sinh thái tooling tương đương, và cộng đồng mới nhỏ hơn nhiều. Nếu bạn đang tuyển người cho một dự án mới, EF Core là kỹ năng phổ biến hơn.
SessionFactory, ISession, ITransaction
Mô hình vòng đời là phần quan trọng nhất khi đọc code NHibernate:
ISessionFactorylà đối tượng nặng, thread-safe, được tạo một lần cho toàn ứng dụng. Nó giữ cấu hình, mapping và second-level cache.ISessionlà đơn vị làm việc nhẹ, không thread-safe, sống theo request hoặc theo một tác vụ. Nó giữ first-level cache (identity map) và là nơi mọi thao tác dữ liệu đi qua.ITransactionbao một đơn vị ghi. Không commit thì thay đổi không xuống database, dù session đãFlush().
// File: Infrastructure/NHibernateSessionFactory.cs
using NHibernate;
using NHibernate.Cfg;
using NHibernate.Dialect;
using NHibernate.Driver;
using NHibernate.Mapping.ByCode;
public static class NHibernateSessionFactory
{
public static ISessionFactory Build(string connectionString)
{
var cfg = new Configuration();
cfg.SetProperty(Environment.ConnectionString, connectionString);
cfg.SetProperty(Environment.Dialect, typeof(MsSql2012Dialect).AssemblyQualifiedName);
cfg.SetProperty(Environment.Driver, typeof(SqlClientDriver).AssemblyQualifiedName);
cfg.SetProperty(Environment.UseSecondLevelCache, "true");
cfg.SetProperty(Environment.UseQueryCache, "true");
cfg.SetProperty(
Environment.CacheProvider,
"NHibernate.Caches.CoreMemoryCache.CoreMemoryCacheProvider, NHibernate.Caches.CoreMemoryCache");
var mapper = new ModelMapper();
mapper.AddMapping<ProductMap>();
cfg.AddMapping(mapper.CompileMappingForAllExplicitlyAddedEntities());
return cfg.BuildSessionFactory();
}
}
// File: Features/Products/ProductRepository.cs
public sealed class ProductRepository(ISessionFactory sessionFactory)
{
public async Task<Product?> GetAsync(int id, CancellationToken ct)
{
using var session = sessionFactory.OpenSession();
using var tx = session.BeginTransaction();
var product = await session.GetAsync<Product>(id, ct);
await tx.CommitAsync(ct);
return product;
}
}
Package NHibernate.Caches.CoreMemoryCache 5.9.0 cung cấp provider trong cấu hình; với Redis, dùng NHibernate.Caches.StackExchangeRedis cùng phiên bản.
Điểm dễ sai: session.Get<T>(id) trả null nếu không có, còn session.Load<T>(id) trả proxy và chỉ ném ObjectNotFoundException khi bạn chạm vào property. Đừng dùng Load như một cách kiểm tra tồn tại.
Mapping: XML, Fluent, Mapping by Code
Ba cách mapping cùng tồn tại, và bạn sẽ gặp cả ba trong thực tế:
hbm.xml: file XML đặt cạnh assembly. Trong hệ thống cũ, đây là nguồn sự thật về mapping; sửa schema mà quên file này là lỗi phổ biến.- FluentNHibernate: mapping bằng C#, dễ refactor và dễ đọc hơn XML. Package 3.5.0 vẫn dùng được với NHibernate 5.7.
- Mapping by Code:
ModelMappercó sẵn trong NHibernate, không cần thư viện ngoài; phù hợp nếu muốn giảm phụ thuộc.
// File: Infrastructure/Mappings/ProductMap.cs
using FluentNHibernate.Mapping;
public sealed class ProductMap : ClassMap<Product>
{
public ProductMap()
{
Table("Products");
Id(p => p.Id).GeneratedBy.Identity();
Map(p => p.Name).Not.Nullable().Length(200);
Map(p => p.Price).Precision(18).Scale(2);
References(p => p.Category).Column("CategoryId");
HasMany(p => p.Items).Inverse().Cascade.AllDeleteOrphan();
}
}
<class name="Product, Domain" table="Products">
<id name="Id">
<generator class="identity" />
</id>
<property name="Name" not-null="true" length="200" />
<property name="Price" precision="18" scale="2" />
<many-to-one name="Category" column="CategoryId" />
</class>
NHibernate không có migration tích hợp. SchemaExport tạo schema từ mapping và SchemaUpdate cố cập nhật, nhưng cả hai không phải công cụ migration có version. Trên production, hãy dùng script SQL có kiểm soát, FluentMigrator hoặc DbUp. Đừng để ORM tự sửa schema.
Lazy loading và khác biệt với EF Core
NHibernate dùng proxy tương tự EF Core: entity hoặc collection được nạp khi có truy cập đầu tiên. Collection thường lazy mặc định; entity cần khai báo lazy="true" hoặc cấu hình Fluent tương ứng. Giống EF Core, proxy yêu cầu property virtual để ghi đè.
var order = session.Get<Order>(id);
// Collection lazy: một query khi dòng này chạy
var total = order.Items.Sum(i => i.Quantity);
// Eager: tải trước trong cùng truy vấn
var orders = session.Query<Order>()
.FetchMany(o => o.Items)
.ToList();
Khác biệt lớn nhất không nằm ở cơ chế mà ở vòng đời session. EF Core thường gắn DbContext với request và dispose cuối request; truy cập navigation sau đó cũng ném lỗi. NHibernate cũng vậy, nhưng vì ISession không thread-safe và thường được mở/đóng thủ công, lỗi LazyInitializationException xuất hiện nhiều hơn trong code cũ. Quy tắc: tải đủ dữ liệu trước khi rời session, hoặc dùng DTO.
Với N+1, cách phát hiện giống hệt EF Core: bật log SQL và đếm câu SELECT cho một request. Lazy loading trong vòng lặp là nguyên nhân số một, không phải ORM chậm.
Second-level cache: điểm NHibernate còn hơn
Đây là khác biệt kiến trúc đáng chú ý. NHibernate có second-level cache trong core: cấu hình provider, region, và query cache. EF Core 10 vẫn không có, phải dùng interceptor bên thứ ba.
// Query cache phải được đánh dấu rõ ràng
var active = session.Query<Product>()
.Where(p => p.IsActive)
.Cacheable()
.ToList();
// Region riêng cho dữ liệu ít đổi, TTL ngắn hơn
var categories = session.Query<Category>()
.Cacheable()
.CacheRegion("catalog")
.ToList();
Hai điều cần biết trước khi bật: query cache không tự có, bạn phải Cacheable(); và cache có thể cũ nếu dữ liệu bị sửa ngoài session — native SQL, job khác, hoặc người sửa trực tiếp database. Region + TTL là biên an toàn, không phải invalidation tức thời. Với dữ liệu tài chính hoặc tồn kho, đừng bật.
Nếu bạn đang chuyển sang EF Core, đừng giả định sẽ có lại hành vi này. EF Core yêu cầu chọn giữa projection + HybridCache, interceptor query cache, hoặc output caching; mỗi cách có hợp đồng riêng.
Vì sao EF Core là mặc định cho dự án mới
| Khía cạnh | NHibernate 5.7.1 | EF Core 10 |
|---|---|---|
| Trạng thái dự án | Maintenance, có target net10.0 |
LTS, Microsoft đầu tư, hỗ trợ đến 2028 |
| Mapping | XML, Fluent, Mapping by Code; rất linh hoạt với schema lạ | Convention, attribute, Fluent API; thuận cho schema mới |
| Schema | Không có migration có version | Migration là tính năng lõi |
| Cache cấp hai | Tích hợp, có query cache | Không tích hợp; cần interceptor hoặc cache tầng ứng dụng |
| Truy vấn | HQL, LINQ, native SQL | LINQ đầy đủ, vector/JSON, LeftJoin/RightJoin |
Với dự án mới, bốn yếu tố quyết định: migration, tooling, tài liệu và khả năng tuyển người. EF Core thắng cả bốn. Hiệu năng không phải lý do chính — cả hai đều đủ nhanh nếu truy vấn đúng; khác biệt thường đến từ N+1 và index, không từ ORM.
Khi nào NHibernate vẫn thắng
- Schema legacy không theo convention. Nhiều bảng nối, khóa phức hợp, inheritance map sang bảng có sẵn, cột tên lạ. NHibernate cho phép mô tả những cấu trúc này chi tiết hơn, ít phải viết lại database.
- Hệ thống đang chạy và có second-level cache đầu tư. Thay ORM có thể mất cache, mất tuning, mất kiến thức vận hành. Rủi ro thường lớn hơn lợi ích.
- Team và quy trình đã ổn định. Nếu 20 người đều hiểu session, mapping và HQL, việc giữ NHibernate cho module hiện tại là quyết định kỹ thuật hợp lý.
- Dialect đặc thù. Oracle, DB2 hoặc database cũ có dialect ổn định trong NHibernate; kiểm tra kỹ trước khi cho rằng EF Core tương đương.
Ngược lại, NHibernate không thắng khi bạn cần migration tự động, tooling hiện đại, tuyển người, hoặc tích hợp vector/JSON của EF Core 10. Đừng chọn nó cho dự án CRUD mới chỉ vì “ổn định lâu năm”.
Chiến lược migration không big-bang
- Kiểm kê theo bounded context. Liệt kê mapping, bảng, query và module. Chọn một module ít rủi ro, không phải module lõi.
- Đóng băng write model của module. Tính năng mới dùng EF Core; không thêm mapping mới vào NHibernate cho module đang chuyển.
- Strangler cho read path trước. Chuyển endpoint đọc sang EF Core, chạy song song và so kết quả trước khi cắt. Read path ít rủi ro hơn write path.
- Một chủ sở hữu schema. Chọn EF Core migration hoặc script SQL làm nguồn sự thật. Không để
SchemaUpdatevà migration cùng sửa schema. - Một ORM trong một transaction. Nếu buộc trộn, dùng chung connection và transaction, và viết integration test cho đường đó. Đừng mở hai transaction trên cùng dữ liệu.
- Định nghĩa điều kiện thoát. Module không còn
ISession, không còn mapping, không còn package NHibernate; xóaSessionFactorycủa module đó.
Điều tối kỵ là chuyển toàn bộ hệ thống trong một lần. Với database lớn, big-bang migration kéo theo hàng tháng không phát hành được tính năng, và lỗi mapping chỉ lộ ra dưới tải thật.
Sai lầm thường gặp
- Giữ
ISessionsống quá lâu. First-level cache phình, dữ liệu cũ, và session không thread-safe. Mở theo đơn vị công việc. - Dùng
Loadđể kiểm tra tồn tại. Proxy không chạm database cho đến khi đọc property; lỗi xuất hiện ở nơi khác. - Lazy loading ngoài session. Serialize entity sau khi session đóng là công thức của
LazyInitializationException. - Bật query cache toàn cục. Dữ liệu cũ, key cardinality cao, hit rate thấp. Chỉ cache query ít đổi và có TTL.
- Dùng
SchemaExporttrên production. Nó tạo/xóa schema theo mapping, không phải công cụ migration. - Trộn EF Core và NHibernate ghi cùng bảng. Transaction, concurrency token và cache không chia sẻ; lỗi rất khó tái hiện.
2027: maintenance không có nghĩa là biến mất
.NET 11 dự kiến GA tháng 11/2026 (STS), EF Core 11 đi cùng và tiếp tục mở rộng vector/AI query. NHibernate nhiều khả năng vẫn phát hành bản vá tương thích, nhưng không có tín hiệu quay lại vị trí mặc định. Vì vậy quyết định hợp lý là: giữ NHibernate ở nơi nó đang chạy ổn, chuyển dần module mới sang EF Core, và ghi rõ điều kiện thoát. Đừng chờ một “NHibernate 6” thay đổi cục diện.
Checklist
- Xác nhận phiên bản: NHibernate 5.7.1 có target
net10.0; kiểm tra FluentNHibernate và cache provider tương thích trước khi nâng cấp. - Vẽ vòng đời
ISessionFactory(singleton) vàISession(per request) trong code hiện tại. - Đếm query mỗi request ở các endpoint nóng; xử lý N+1 trước khi bàn đến migration.
- Rà lại second-level cache: query nào
Cacheable(), region nào, TTL bao lâu, ai ghi ngoài session. - Chọn một module nhỏ và chuyển read path sang EF Core trước, có so sánh kết quả.
- Chốt một công cụ sở hữu schema; cấm ORM tự cập nhật schema trên production.
Đọc tiếp: Bắt đầu với EF Core Code-First để so sánh mô hình và migration; So sánh EF Core, Dapper và RepoDB để đặt NHibernate vào bức tranh công cụ dữ liệu; và Second-level caching trong EF Core để thấy rõ điều NHibernate có sẵn mà EF Core không có.



