Dapper 本身不直接解析 PostgreSQL 的 jsonb 字段，但可通过 Npgsql 驱动将其映射为 string、JToken、JsonDocument 或自定义 POCO；读取时依赖 Npgsql 自动转换，写入时必须显式指定 NpgsqlDbType.Jsonb 类型。
Dapper 本身不直接解析 PostgreSQL 的 jsonb 字段，但它可以无缝读取为 string、JToken（Newtonsoft.Json）、JsonDocument（System.Text.Json）或自定义 POCO，关键在于正确配置类型映射和使用合适的序列化器。
将 JSONB 映射为 string（最简单方式）
PostgreSQL 的 jsonb 在数据库驱动（如 Npgsql）中默认映射为 string。Dapper 直接接收即可，适合不需要立即解析、仅需透传或延迟解析的场景。
- 确保 Npgsql 已安装（如
Npgsql 7+），它会自动把jsonb列转成 UTF-8 字符串 - Dapper 查询时，字段可直接映射到 C# 的
string属性 - 示例：
var user = connection.QueryFirstOrDefault<User>("SELECT id, name, metadata FROM users WHERE id = @id", new { id = 123 }); // 其中 User.metadata 是 string 类型
用 Newtonsoft.Json（Json.NET）映射为 JToken 或自定义对象
如果你习惯用 Newtonsoft.Json，推荐映射为 JToken（灵活）或强类型的 POCO（类型安全）。
- 添加引用：
Newtonsoft.Json和Dapper.Contrib（可选） - 映射为
JToken：Npgsql 支持自动转换jsonb → JToken，前提是启用JsonNetTypeHandler（需手动注册） - 更常用做法：先读成
string，再用JToken.Parse()或JsonConvert.DeserializeObject<t>()</t> - 示例（手动反序列化）：
var row = connection.QuerySingle<dynamic>("SELECT metadata FROM users WHERE id = @id", new { id = 123 }); string json = row.metadata; var settings = new JsonSerializerSettings { DateParseHandling = DateParseHandling.None }; var data = JsonConvert.DeserializeObject<UserSettings>(json, settings);
用 System.Text.Json 映射为 JsonDocument 或 record/class
.NET 5+ 推荐使用原生 System.Text.Json，性能更好、无额外依赖。
-
jsonb列仍作为string读出，再用JsonSerializer.Deserialize<t></t>或JsonDocument.Parse() - 若需在查询时直接绑定为
JsonElement，可配合 Npgsql 的JsonElementHandler（需 Npgsql 7.0+ 并启用） - 示例（轻量解析）：
var jsonStr = connection.QuerySingle<string>("SELECT metadata FROM users WHERE id = @id", new { id = 123 }); using JsonDocument doc = JsonDocument.Parse(jsonStr); JsonElement root = doc.RootElement; string theme = root.GetProperty("ui").GetProperty("theme").GetString(); // 安全导航
写入 JSONB：参数需显式指定 NpgsqlDbType.Jsonb
插入或更新 jsonb 字段时，Dapper 不会自动推断类型，必须通过 NpgsqlParameter 明确指定 NpgsqlDbType.Jsonb。
- 错误写法：
new { metadata = "{\"name\":\"test\"}" }→ 可能被当作文本存为text类型 - 正确写法（推荐）：
var param = new NpgsqlParameter("@metadata", NpgsqlDbType.Jsonb) { Value = JsonSerializer.Serialize(new { name = "test", active = true }) }; connection.Execute("INSERT INTO users (name, metadata) VALUES (@name, @metadata)", new { name = "Alice", param }); - 也可用匿名对象 +
DynamicParameters封装，保持 Dapper 风格
基本上就这些。核心是：读取靠 Npgsql 自动转换，Dapper 负责“搬运”；解析靠你选的 JSON 库；写入必须显式声明 Jsonb 类型。不复杂但容易忽略类型声明这一步。
