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]。
