FluentNHibernate配置异常求助：单元测试报错问题排查

一、版本兼容问题排查及解决 #

• 核对FluentNHibernate、NHibernate与.NET 6的版本匹配：FluentNHibernate 3.2及以上版本才支持.NET 6，对应的NHibernate需要5.3+版本。打开NuGet包管理器检查当前安装版本，若版本过低，直接升级到兼容的稳定版。
• 检查SQL Server驱动版本：确保使用的Microsoft.Data.SqlClient（推荐）或System.Data.SqlClient是支持.NET 6的最新稳定版，旧版本驱动可能引发兼容性问题。

二、逻辑配置错误排查及解决 #

代码无编译错误但触发运行时异常，大概率出在配置环节，按以下步骤排查：

• 验证映射类配置：确保映射类继承自ClassMap<Product>，所有需要映射的属性都完成正确配置，比如主键Id(x => x.Id)的生成策略是否匹配数据库，普通属性Map(x => x.ProductName)是否正确关联实体字段。
• 检查数据库连接字符串：确认SqlServerHelper中的连接字符串包含正确的服务器地址、数据库名、认证方式（Windows/SQL Server认证），可直接用该连接字符串测试数据库连接是否正常。
• 核对NHibernate构建代码：确保配置中指定了正确的SQL Server方言（比如SQL Server 2012及以上用MsSql2012Dialect），且正确加载了映射程序集，示例配置代码：

var config = Fluently.Configure()
    .Database(MsSqlConfiguration.MsSql2012
        .ConnectionString("YourValidConnectionString"))
    .Mappings(m => m.FluentMappings.AddFromAssemblyOf<ProductMap>());

• 确认实体类virtual属性完整性：所有被映射的属性（包括未来可能添加的导航属性）都必须添加virtual修饰，NHibernate需要通过代理实现延迟加载等功能。
• 检查数据库权限与存在性：单元测试运行账户需要具备目标数据库的访问/创建权限；若数据库未提前创建，可在NHibernate配置中添加自动创建逻辑：ExposeConfiguration(cfg => new SchemaExport(cfg).Create(false, true))。

三、进阶排查技巧 #

捕获FluentConfigurationException的InnerException，它会包含具体的错误详情（比如映射字段不匹配、连接失败、方言错误等）；也可以启用NHibernate日志输出，获取更完整的运行时日志，精准定位问题根源。

内容的提问来源于stack exchange，提问作者Gökay Aıkgöz