Fluent NHibernate 中 PostgreSQL 的 PascalCase 命名问题解析

问题背景

在使用 Fluent NHibernate 进行 SQL Server 迁移到 PostgreSQL 的过程中，开发者遇到了一个关于 PascalCase 命名约定的特殊问题。虽然通过自定义命名策略能够正确保留表名和列名的大小写格式，但在使用 SchemaUpdate 功能时却遇到了识别问题。

核心问题分析

当表名和列名采用 PascalCase 命名时，PostgreSQL 需要将这些标识符用引号括起来才能正确识别。然而，Fluent NHibernate 的 SchemaUpdate 功能在以下方面存在问题：

1. 元数据获取失败：databaseMetadata.GetTableMetadata 方法对于带引号的表名返回 null 值
2. 表识别错误：系统错误地将现有表识别为不存在，导致尝试重新创建表结构
3. 命名策略冲突：混合使用 NHibernate 的 INamingStrategy 和 Fluent NHibernate 的命名约定可能导致预期外的行为

解决方案

经过深入分析，正确的解决路径应该是：

1. 使用 Fluent NHibernate 的命名约定

替代 INamingStrategy，应采用 Fluent NHibernate 内置的命名约定机制：

.FluentMappings.Conventions.Add(
    ConventionBuilder.Class.Always(c => c.Table($"\"{c.EntityType.Name}\"")),
    ConventionBuilder.Property.Always(p => p.Column($"\"{p.Name}\""))
);

这种方法直接在映射层面处理引号问题，比 INamingStrategy 介入得更早，效果更可靠。

2. 处理多对多关系的命名

对于多对多关系的中间表，需要额外添加特定的命名约定：

ConventionBuilder.HasManyToMany.Always(rel => {
    rel.Table($"\"{rel.EntityType.Name}{rel.OtherSide.EntityType.Name}\"");
    rel.Key.Column($"\"{rel.EntityType.Name}Id\"");
    rel.Relationship.Column($"\"{rel.OtherSide.EntityType.Name}Id\"");
});

3. 审计表的特殊处理

审计表需要单独配置其命名策略，确保引号正确应用：

ConventionBuilder.Class.Where(t => t.Name.EndsWith("Audit"))
    .Always(c => c.Table($"\"{c.EntityType.Name}\""));

实施建议

1. 版本兼容性：确保使用 NHibernate 5.5.1 和 Fluent NHibernate 3.3.0 或更高版本
2. 彻底测试：在应用命名约定后，应全面测试各种关系映射和查询场景
3. 逐步迁移：对于大型项目，建议分阶段实施命名约定更改
4. 日志监控：启用详细的 SQL 日志输出，验证生成的 SQL 语句是否符合预期

总结

PostgreSQL 对标识符大小写的严格处理要求与 Fluent NHibernate 的交互需要特别注意。通过正确使用 Fluent NHibernate 的命名约定机制而非 INamingStrategy，可以有效地解决 PascalCase 命名在 SchemaUpdate 过程中的识别问题。对于复杂场景如多对多关系和审计表，则需要额外的约定配置来确保一致性。