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 });
<p>var issues = connection.Query<Issue>("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<t></t>或
IEnumerable<t></t>—— Npgsql 只直接支持一维数组（
T[]）。
处理 NULL 数组或空数组边界情况
PostgreSQL 中数组字段可以是
NULL，也可能是一个空数组
{}，二者语义不同。C# 中对应为 null或
new string[0]。 插入
null：Dapper + Npgsql 会正确写入 SQL
NULL插入空数组：
new string[0]会被转为 PostgreSQL 的
{}
读取时，数据库返回 NULL→ C# 为
null；返回
{} → C# 为长度为 0 的数组
建议在业务逻辑中显式判空，避免 NullReferenceException：
if (issue.Tags?.Length > 0) { ... }需要自定义时：注册 TypeHandler（进阶）
如果要用非标准类型（比如把 JSON 数组映射为
string[]），或统一处理所有数组字段的序列化逻辑，可实现
IDbCustomTypeHandler<t></t>： 继承
SqlMapper.TypeHandler<t></t>（Dapper v2+） 重写
Parse和
SetValue，内部调用
NpgsqlParameter.Value = ...注册：
SqlMapper.AddTypeHandler<string>(new PgStringArrayHandler());</string>
不过绝大多数场景下，直接依赖 Npgsql 的默认行为更简洁可靠。
基本上就这些。只要用对 Npgsql 版本、字段类型声明匹配、传参用数组而非集合，Dapper 操作 PG 数组就很自然——它不复杂，但容易忽略数组维度和 NULL 语义的区别。
