Mybatis 查询语句条件为枚举类型时报错的解决

针对问题“Mybatis 查询语句条件为枚举类型时报错”的解决，可以采取以下步骤：

1. 确认报错信息

在解决问题之前，需要先确认报错信息。针对“Mybatis 查询语句条件为枚举类型时报错”的情况，通常表现为：

org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database. Cause: org.springframework.jdbc.BadSqlGrammarException: 
PreparedStatementCallback; bad SQL grammar [SELECT * FROM my_table WHERE status = ?]; nested exception is java.sql.SQLException: 
Parameter index out of range (1 > number of parameters, which is 0).

其中，报错原因一般都包含两个关键信息：

1. BadSqlGrammarException：SQL 语法不正确
2. Parameter index out of range：参数索引超出范围

2. 针对枚举类型的情况进行处理

在 Mybatis 的 Mapper.xml 中，如果查询语句条件为枚举类型，可以采用以下两种方式进行处理：

2.1. 使用 @EnumValue 注解

在实体类中，定义枚举类型时，需要使用 @EnumValue 注解为枚举类型的字段指定枚举值。例如：

public enum StatusEnum {

    NEW(0, "新建"),
    PROCESSING(1, "处理中"),
    SUCCESS(2, "成功"),
    FAIL(3, "失败");

    @EnumValue
    private final int value;

    private final String desc;

    StatusEnum(int value, String desc) {
        this.value = value;
        this.desc = desc;
    }

    public int getValue() {
        return value;
    }

    public String getDesc() {
        return desc;
    }
}

然后，针对该枚举类型的字段，在 Mapper.xml 中使用 #{fieldName,typeHandler=EnumOrdinalTypeHandler} 占位符进行查询。例如：

<select id="selectByStatus" resultType="MyEntity">
    SELECT * FROM my_table WHERE status = #{status,typeHandler=EnumOrdinalTypeHandler}
</select>

这里的 EnumOrdinalTypeHandler 是 Mybatis 自带的枚举类型处理器，可以将枚举类型的值转换为其在枚举类型中的序号。

2.2. 自定义类型处理器

如果使用 EnumOrdinalTypeHandler 处理器无法满足需求，可以自定义类型处理器。自定义类型处理器需要继承 BaseTypeHandler 类，并实现 getNullableResult 和 setNonNullParameter 两个方法。例如：

public class StatusEnumTypeHandler extends BaseTypeHandler<StatusEnum> {

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

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

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

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

其中，getNullableResult 方法用于将数据库中的字段值转换为 Java 对象，setNonNullParameter 方法用于将 Java 对象转换为 JDBC 参数。

然后，在 Mapper.xml 中使用 #{fieldName,jdbcType=INTEGER,typeHandler=com.example.StatusEnumTypeHandler} 占位符进行查询。例如：

<select id="selectByStatus" resultType="MyEntity">
    SELECT * FROM my_table WHERE status = #{status,jdbcType=INTEGER,typeHandler=com.example.StatusEnumTypeHandler}
</select>

这里的 com.example.StatusEnumTypeHandler 是自定义的类型处理器类所在的包名与类名。需要注意的是，使用自定义类型处理器时，参数 jdbcType 应该与实体类枚举类型字段在数据库中的字段类型保持一致。

至此，以上两种方式都已经能够解决“Mybatis 查询语句条件为枚举类型时报错”的问题。