jOOQ插入含\0的JSON到Postgres JSONB列报错咨询自动转义方法

核心结论 #

jOOQ不会自动转义\0（即Unicode \u0000 空字符），该报错本质是PostgreSQL的底层限制，并非jOOQ转义逻辑缺失导致：
PostgreSQL的JSON、JSONB类型从实现层面就不支持存储\u0000空字符，不存在任何转义手段可以绕开这个数据库侧的强制约束。

异常来源说明 #

抛出的异常是PostgreSQL服务端直接返回的，和客户端工具无关：

• 无论使用jOOQ、原生JDBC还是直接在psql命令行执行插入，只要传入的JSON内容包含\u0000，都会触发完全一致的unsupported Unicode escape sequence报错。
• jOOQ处理JSON字段时仅做标准JSON语法层面的转义，不会主动修改JSON内容本身的字符：\u0000属于JSON规范允许的合法Unicode字符，jOOQ没有理由默认过滤这类字符。

可行处理方案 #

• 前置清洗字符（推荐方案）：在数据序列化为JSON之前，或者将JSON参数传给jOOQ执行插入之前，主动清理所有字符串字段中携带的\u0000空字符，可以直接替换为空串，也可以替换为业务约定的占位符。Java侧预处理参考代码：

  // 移除原始内容中的空字符
  String safeValue = originalValue.replace("\0", "");
  // 对清洗后的内容做JSON序列化，再传入jOOQ执行插入
  

• 优先使用jOOQ内置JSON类型封装：如果使用jOOQ 3.14及以上版本，不要直接传入拼接好的JSON字符串，改用JSONB.jsonb()方法传入结构化的JSON值，可以减少序列化环节引入非法字符的概率，但如果内容本身携带\u0000，依然会触发数据库报错，前置清洗是必须步骤。
• 不要尝试通过多层转义的方式强行存入\u0000：转义后存入的内容会变成普通字面量，读取时需要额外反转义，极易造成数据不一致。

内容的提问来源于stack exchange，提问作者DWilches