MyBatis 中自定义 typeHandler 不生效，需全局注册并显式声明于 resultMap；#{} 支持类型转换，${} 仅字符串拼接；JSON/LocalDateTime 等需专用 TypeHandler；嵌套 resultMap 中 typeHandler 需单独指定，且必须双向实现。
MyBatis 中
的 typeHandler 不生效？检查注册方式和
作用域
MyBatis 默认对基本类型（
、
、
）有内置
，但自定义类型（如枚举、
、JSON 字符串转对象）必须显式绑定，否则会报
或字段为
。
常见错误是只在
里写了
属性，却没在全局或映射语句中真正启用：
中的
仅对当前字段生效，但前提是该
已被 MyBatis 加载（即已注册）
未注册的
会被静默忽略，不会报错，只返回
推荐在
中全局注册：
若用 Spring Boot + MyBatis-Plus，改用
类中注册
XML 中
和
对数据类型的影响完全不同
是预编译参数占位符，MyBatis 会根据字段类型自动选择
；
是字符串拼接，绕过所有类型转换逻辑，直接转成
后拼入 SQL —— 这是多数“类型丢失”的根源。
例如传入
：
→ 正确：MyBatis 调用
，生成带时区的 JDBC 参数
→ 错误：调用
，结果可能是
，数据库报语法错误或
隐式转换
失败
属于合法动态列名场景，但绝不能用于值参数
PostgreSQL / MySQL 的
/
字段在 XML 映射中需要专用 TypeHandler
数据库原生 JSON 类型无法被 MyBatis 默认处理，直接映射到
会丢失结构，映射到
则抛
。
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
下载
必须使用第三方
，例如 Jackson：
Maven 引入：
和
（后者仅支持 JSR310 时间类型，不支持 JSON）
自定义
，重写
和
，内部用
序列化/反序列化
在
中指定：
注意：MySQL 8.0+ 的
类型需 JDBC 驱动开启
才能读取二进制 JSON 值，否则返回空
嵌套
时子映射的 typeHandler 容易被父级覆盖
当主
引用另一个
（如
），子映射中声明的
可能被忽略——MyBatis 优先使用父级
的类型推导逻辑。
解决方法很直接：
不要依赖嵌套映射自动继承
，每个字段都显式声明
若子对象字段类型与数据库列类型不一致（如 DB 存
，Java 期望
），必须在子
的
中写死
避免用
，它会跳过所有手动配置的
最常被忽略的一点：
必须同时实现
（写入）和
（读取），缺一不可；只重写一半会导致单向转换失败，现象是插入正常、查询为
。
resultMapStringIntegerDateTypeHandlerLocalDateTimeCannot convert value of type 'java.lang.String' to required typenullresultMaptypeHandlerresultMapTypeHandlerTypeHandlernullmybatis-config.xml
@ConfigurationConfiguration.addTypeHandler(...)#{}${}#{}TypeHandler${}StringLocalDateTimeWHERE create_time > #{startTime}LocalDateTimeTypeHandlerWHERE create_time > '${startTime}'toString()"2024-05-20T14:30:00"ORDER BY ${sortField}jsonbJSONStringObjectClassCastExceptionTypeHandlercom.fasterxml.jackson.core:jackson-databindorg.mybatis:mybatis-typehandlers-jsr310JsonTypeHandlersetNonNullParametergetNullableResultObjectMapperresultMapJSONallowPublicKeyRetrieval=trueresultMapresultMapresultMaptypeHandlerresultMaptypeHandlertypeHandlerVARCHAREnumresultMaptypeHandlerautoMapping="true"typeHandlerTypeHandlersetParametergetResultnull