如何通过NHibernate的.hbm映射将String映射为PostgreSQL的citext类型？

我之前也踩过这个坑，你配置了sql-type="citext"却没生效，大概率是因为NHibernate的方言没正确识别citext类型，或者数据库字段实际没被创建为citext。咱们一步步来搞定：

1. 先确认数据库字段确实是citext类型 #

别默认映射配置已经把字段改成citext了，先手动检查表结构：

SELECT data_type FROM information_schema.columns WHERE table_name='your_table' AND column_name='username';

如果结果不是citext，手动修改字段类型：

ALTER TABLE your_table ALTER COLUMN username TYPE citext;

要是你用NHibernate自动生成表，你的<column sql-type="citext" />配置本身是对的，但前提是NHibernate方言能识别这个类型。

2. 让NHibernate方言支持citext类型 #

默认的PostgreSQL方言没注册citext类型，导致NHibernate处理查询时还是把它当普通varchar。你需要自定义方言：

创建一个继承自PostgreSQLDialect的自定义方言类：

using NHibernate.Dialect;
using NHibernate.SqlTypes;
using System.Collections.Generic;

public class CitextPostgreSQLDialect : PostgreSQLDialect
{
    public override void RegisterColumnTypes(IDictionary<string, SqlType> columnTypes)
    {
        base.RegisterColumnTypes(columnTypes);
        // 注册citext类型，映射到DbType.String
        columnTypes.Add("citext", new SqlType(DbType.String));
    }
}

然后在NHibernate配置文件里指定使用这个方言：

<property name="dialect">YourProjectNamespace.CitextPostgreSQLDialect, YourProjectAssembly</property>

3. 更稳妥的方式：使用自定义NHibernate类型 #

如果想更明确控制类型映射，可以创建自定义的CitextType：

using NHibernate.Type;
using NHibernate.SqlTypes;

public class CitextType : StringType
{
    public CitextType() : base(new SqlType(DbType.String, "citext"))
    {
    }

    public override string Name => "Citext";
}

然后在hbm映射文件里直接指定这个类型，替代sql-type：

<property name="UserName" type="YourProjectNamespace.CitextType, YourProjectAssembly">
    <column name="username" />
</property>

这种方式让映射逻辑更清晰，NHibernate会明确知道这个字段对应citext类型。

4. 验证查询是否生效 #

配置完成后，测试一个大小写不同的查询，比如：

var user = session.Query<User>().FirstOrDefault(u => u.UserName == "johnDoe");

查看NHibernate生成的SQL，应该是直接比较username = 'johnDoe'，而PostgreSQL的citext类型会自动做大小写不敏感匹配。

如果还是有问题，检查NHibernate和Npgsql的版本兼容性——尽量用较新的版本，新版本对citext的支持更完善。

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