Dapper如何处理PostgreSQL的JSONB字段 Dapper查询JSONB数据

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，性能更好、无额外依赖。

标签： js json app c# .net