mybatis 通过泛型化 basetypehandler 配合 jackson 或 fastjson2 实现 json 字段精准双向转换，需显式指定 typehandler、适配数据库 jdbc 类型，并为泛型集合定制处理器以避免类型擦除问题。
MyBatis 通过自定义 TypeHandler 处理复杂 JSON 字段，核心是让 Java 对象与数据库中的 JSON 字符串自动双向转换，避免在业务代码里反复调用 JSON.toJSONString() 或 JSON.parseObject()。关键不在“能不能”，而在于“怎么写得稳、用得准、泛型不翻车”。
明确目标类型，选对基类和序列化工具
处理复杂结构（如 List<orderitem></orderitem>、嵌套对象、含泛型的 Map）时，不能直接继承 BaseTypeHandler<object></object>——它会丢失类型信息，反序列化后变成 LinkedHashMap，强转极易报错。
- 优先用
BaseTypeHandler<t></t>+ 构造器传入具体 Class，比如new JsonTypeHandler(UserPreference.class) - 序列化工具推荐 Jackson（稳定、泛型支持好），避免 Fastjson 2.x 以下版本对泛型擦除处理不严谨的问题
- 若项目已统一用 Alibaba Fastjson2，可继承
AbstractJsonTypeHandler<t></t>（MyBatis-Plus 提供），重写parse和toJson即可
正确注册并绑定到字段
TypeHandler 必须被 MyBatis 明确识别并应用到对应字段，否则形同虚设。
- 实体类中用
@TableField(typeHandler = JsonTypeHandler.class)（MyBatis-Plus）或@Result(typeHandler = ...)（原生 MyBatis） - XML 映射文件中，
<result></result>或<parameter></parameter>标签必须显式指定typeHandler全限定名，例如：<result property="config" column="config" typehandler="com.example.JsonTypeHandler"></result> - 全局注册（可选）：在
mybatis-config.xml中声明，适用于多处复用且类型固定的情况
适配不同数据库的 JDBC 类型
MySQL 的 JSON 字段本质仍是字符串（JDBC Type VARCHAR），但 PostgreSQL 的 json / jsonb 类型需用 OTHER 或专用 PGobject。
- MySQL 场景：
setNonNullParameter直接ps.setString(...)；getNullableResult直接rs.getString(...) - PostgreSQL 场景：写入时需 new
PGobject("json", jsonStr)并ps.setObject(...)；读取时先rs.getObject(...)再转型为PGobject，再取其getValue() - 别忽略
jdbcType参数：在 XML 中手动指定jdbcType="OTHER"可避免类型推断错误
泛型集合字段要单独封装处理器
像 List<tag></tag> 这类字段，通用 JsonTypeHandler<t></t> 无法自动推导泛型实际类型——Java 运行时已擦除。
- 方案一：为每种集合定义专用处理器，如
TagListTypeHandler extends BaseTypeHandler<list>></list>，在parse中硬编码objectMapper.readValue(json, new TypeReference<list>>() {})</list> - 方案二：使用工厂模式，在构造器传入
TypeReference实例，提升复用性 - 切忌在
getNullableResult里用objectMapper.convertValue(..., List.class)——它不保留泛型信息，结果仍是List<linkedhashmap></linkedhashmap>
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
