Dapper 通过 Npgsql 驱动原生支持 PostgreSQL 数组类型，需使用 T[]（如 string[]）、匹配列类型、较新版本 Npgsql（≥6.0）和 Dapper（≥2.0），并注意 NULL 与空数组 {} 的语义区别。
Dapper 本身不原生支持 PostgreSQL 的数组类型（如 INTEGER[]、TEXT[] 等），但可以通过自定义类型映射或手动处理实现正确读写。关键在于利用 Npgsql（PostgreSQL .NET 驱动）对数组的内置支持，并让 Dapper 正确传递/解析这些值。
使用 Npgsql 自带的数组支持（推荐）
Npgsql 能自动将 .NET 数组（int[]、string[]、Guid[] 等）映射为 PostgreSQL 数组，前提是参数类型和列类型匹配，且 Dapper 不干扰底层参数设置。
- 确保使用较新版本的 Npgsql（≥ 6.0） 和 Dapper（≥ 2.0）
- 直接传入 C# 数组作为参数，Npgsql 会自动处理序列化
- 查询结果中，Npgsql 也能自动将
TEXT[]列映射为string[]，无需额外配置
示例：
var tags = new[] { "bug", "high-priority", "backend" };
connection.Execute("INSERT INTO issues (id, tags) VALUES (@id, @tags)",
new { id = 123, tags = tags });
var issues = connection.Query("SELECT id, tags FROM issues WHERE array_length(tags, 1) > 0");
// Issue 类中 tags 字段应为 string[]
在 POCO 中正确声明数组字段
Dapper 映射时依赖属性名与列名一致，且类型可被 Npgsql 识别。常见支持的数组类型包括：
-
int[]↔INTEGER[] -
string[]↔TEXT[]或VARCHAR[] -
DateTime[]↔TIMESTAMP[] -
Guid[]↔UUID[] - 自定义类型需配合
NpgsqlConnection.GlobalTypeMapper.MapEnum或MapComposite
注意：不要用 List 或 IEnumerable —— Npgsql 只直接支持一维数组（T[]）。
处理 NULL 数组或空数组边界情况
PostgreSQL 中数组字段可以是 NULL，也可能是一个空数组 {}，二者语义不同。C# 中对应为 null 或 new string[0]。
- 插入
null：Dapper + Npgsql 会正确写入 SQLNULL - 插入空数组：
new string[0]会被转为 PostgreSQL 的{} - 读取时，数据库返回
NULL→ C# 为null；返回{}→ C# 为长度为 0 的数组
建议在业务逻辑中显式判空，避免 NullReferenceException：
if (issue.Tags?.Length > 0) { ... }需要自定义时：注册 TypeHandler（进阶）
如果要用非标准类型（比如把 JSON 数组映射为 string[]），或统一处理所有数组字段的序列化逻辑，可实现 IDbCustomTypeHandler：
- 继承
SqlMapper.TypeHandler（Dapper v2+） - 重写
Parse和SetValue，内部调用NpgsqlParameter.Value = ... - 注册：
SqlMapper.AddTypeHandler(new PgStringArrayHandler());
不过绝大多数场景下，直接依赖 Npgsql 的默认行为更简洁可靠。
基本上就这些。只要用对 Npgsql 版本、字段类型声明匹配、传参用数组而非集合，Dapper 操作 PG 数组就很自然——它不复杂，但容易忽略数组维度和 NULL 语义的区别。
