java mybatis怎么处理枚举

在 MyBatis（Java） 中处理枚举（enum）有多种方式，取决于你使用的 MyBatis 版本、是否使用 MyBatis-Plus、以及枚举在数据库中的存储形式（存 code / 存 name / 存序号）。

下面从 原生 MyBatis 和 MyBatis-Plus 两个角度系统说明。

一、数据库中枚举的常见存储方式

二、原生 MyBatis 处理枚举

方式 1：使用 MyBatis 自带 EnumTypeHandler（默认）

默认行为：存枚举的 name

public enum Status {
    ENABLE, DISABLE
}

private Status status;

status = #{status}

✅ 数据库存：ENABLE / DISABLE
❌ 不能自定义 code

方式 2：实现 TypeHandler（推荐）

1️⃣ 定义枚举（带 code）

public enum Status {
    ENABLE(1),
    DISABLE(0);

    private final int code;

    Status(int code) {
        this.code = code;
    }

    public int getCode() {
        return code;
    }

    public static Status of(int code) {
        for (Status s : values()) {
            if (s.code == code) return s;
        }
        throw new IllegalArgumentException("未知状态");
    }
}

2️⃣ 自定义 TypeHandler

@MappedTypes(Status.class)
@MappedJdbcTypes(JdbcType.INTEGER)
public class StatusTypeHandler extends BaseTypeHandler<Status> {

    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, Status parameter, JdbcType jdbcType) throws SQLException {
        ps.setInt(i, parameter.getCode());
    }

    @Override
    public Status getNullableResult(ResultSet rs, String columnName) throws SQLException {
        return Status.of(rs.getInt(columnName));
    }

    @Override
    public Status getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        return Status.of(rs.getInt(columnIndex));
    }

    @Override
    public Status getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        return Status.of(cs.getInt(columnIndex));
    }
}

3️⃣ 注册 TypeHandler

方式 A：XML 中指定

<result column="status" property="status"
        typeHandler="com.xxx.StatusTypeHandler"/>

方式 B：全局配置

mybatis:
  type-handlers-package: com.xxx.handler

三、MyBatis-Plus 处理枚举（强烈推荐）

方式 1：@EnumValue（最常用）

枚举定义

public enum Status {
    ENABLE(1, "启用"),
    DISABLE(0, "禁用");

    @EnumValue
    private final int code;

    private final String desc;

    Status(int code, String desc) {
        this.code = code;
        this.desc = desc;
    }
}

实体类

@Data
public class User {
    private Long id;
    private Status status;
}

配置（Spring Boot）

mybatis-plus:
  configuration:
    default-enum-type-handler: com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler

✅ 数据库直接存 0 / 1

方式 2：@JsonValue（返回前端）

public enum Status {
    ENABLE(1, "启用"),
    DISABLE(0, "禁用");

    @EnumValue
    private final int code;

    @JsonValue
    private final String desc;
}

四、常见问题

❓ 数据库存 0/1，但查出来是 null？

• 没加 @EnumValue
• TypeHandler 没注册
• 字段类型不匹配（INT vs VARCHAR）

❓ 枚举顺序变了导致数据错乱？

• ❌ 不要用 ordinal
• ✅ 用 code

五、推荐方案总结

如果你愿意，可以告诉我：

• ✅ 是否使用 MyBatis-Plus
• ✅ 数据库字段类型（INT / VARCHAR）
• ✅ Spring Boot 还是纯 MyBatis

我可以直接给你一套 可复制的完整代码。