核心是绕过mybatis默认枚举映射、接管转换逻辑，需先明确数据库字段类型与业务码值约定，再依场景选用内置typehandler、泛型自定义handler或mybatis-plus的@enumvalue注解实现code字段双向映射。
处理Java枚举与MyBatis集成时的非标状态映射，核心在于**绕过默认行为、接管转换逻辑**。MyBatis默认只认name()或ordinal()，但现实业务中状态常以自定义码值（如"01"、"ENABLE"、"1001"）或描述字段（如"已审核"）存在，这就需要主动干预映射过程。
明确数据库字段类型与业务码值约定
这是所有方案的前提。先确认三点：
- 数据库字段是字符串（VARCHAR）还是数字（TINYINT/INT）？
- 该字段实际存的是什么——是枚举常量名（
ACTIVE）、序号（0）、自定义code（"1"），还是中文描述（"启用"）？ - 这个约定是否全局统一？比如多个枚举共用同一套code编码规则？
例如，若数据库status字段存的是"1"、"2"、"99"，而你的枚举是：
public enum UserStatus {
ENABLE(1, "启用"),
DISABLE(2, "禁用"),
LOCKED(99, "锁定");
private final int code;
private final String desc;
// 构造+getter
}
那就不能依赖默认行为，必须让MyBatis知道：入库时写code，查库时按code反查枚举。
优先使用MyBatis内置TypeHandler快速适配
不写代码也能解决多数常见非标场景：
- 存字符串码值（如
"ENABLE"）→ 用EnumTypeHandler（默认，无需配置） - 存数字序号（如
0,1）→ 显式指定EnumOrdinalTypeHandler： - 存自定义整型码值（如
1,2）→ 用EnumTypeHandler不适用，需自定义；但若所有枚举都带code字段且类型为int，可考虑通用方案
编写泛型TypeHandler统一处理带code的枚举
当多个枚举都实现统一接口（如Dict或IEnum）时，一个处理器能覆盖全部：
- 定义接口：
public interface IEnum { int getCode(); String getDesc(); } - 枚举实现该接口，提供
getCode()方法 - 继承
BaseTypeHandler<t extends ienum></t>，重写setNonNullParameter（写库时取value.getCode()）和getNullableResult（读库时遍历枚举找匹配code的实例） - 在Mapper XML中声明：
这种方式避免了为每个枚举写单独处理器，也比反射更安全高效。
MyBatis-Plus用户请直接用@EnumValue注解
如果你用的是MyBatis-Plus（而非原生MyBatis），它提供了更简洁的声明式方案：
- 在枚举字段上加
@EnumValue注解，标记哪个属性是持久化字段：private final int code;<br> @EnumValue<br> public int getCode() { return code; } - 实体类字段保持
UserStatus status不变 - MP会自动识别并完成
code ↔ 枚举实例双向转换，无需XML配置或注册TypeHandler
注意：需确保MP版本≥3.4.0，且全局配置开启枚举处理（mybatis-plus.configuration.default-enum-type-handler=com.baomidou.mybatisplus.extension.handlers.MybatisEnumTypeHandler）。
非标映射不是配置问题，而是契约问题——只要数据库字段含义和Java枚举字段含义对齐了，剩下的就是选对工具链。从内置Handler到泛型处理器再到MP注解，路径清晰，不必硬编码if-else做手工转换。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
