MyBatis升级后参数映射异常及查询结果异常求助

升级MyBatis到3.5.x后，框架对参数类型的校验和解析逻辑更严格，老版本中隐式支持的Jackson ArrayNode类型，新版本需要明确的类型处理逻辑。你遇到的问题分两步：首先是TypeHandler缺失导致的初始化报错，其次是遍历ArrayNode时参数绑定异常导致查询结果不符合预期。

1. 完善自定义TypeHandler逻辑 #

你实现的ArrayNodeTypeHandler可能仅处理了ArrayNode作为单个参数的场景，但foreach遍历ArrayNode时，每个token是JsonNode类型，MyBatis依然找不到对应的TypeHandler。需要补充实现JsonNodeTypeHandler，并通过全局注册或显式指定的方式让MyBatis识别：

JsonNodeTypeHandler示例实现

public class JsonNodeTypeHandler extends BaseTypeHandler<JsonNode> {
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();

    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, JsonNode parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter.asText());
    }

    @Override
    public JsonNode getNullableResult(ResultSet rs, String columnName) throws SQLException {
        try {
            return OBJECT_MAPPER.readTree(rs.getString(columnName));
        } catch (IOException e) {
            throw new SQLException("解析JsonNode失败，列名：" + columnName, e);
        }
    }

    @Override
    public JsonNode getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        try {
            return OBJECT_MAPPER.readTree(rs.getString(columnIndex));
        } catch (IOException e) {
            throw new SQLException("解析JsonNode失败，列索引：" + columnIndex, e);
        }
    }

    @Override
    public JsonNode getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        try {
            return OBJECT_MAPPER.readTree(cs.getString(columnIndex));
        } catch (IOException e) {
            throw new SQLException("解析JsonNode失败，列索引：" + columnIndex, e);
        }
    }
}

注册TypeHandler

在MyBatis配置文件中全局注册：

<typeHandlers>
    <typeHandler handler="com.your.package.ArrayNodeTypeHandler"/>
    <typeHandler handler="com.your.package.JsonNodeTypeHandler"/>
</typeHandlers>

或者在Mapper的foreach中显式指定：

<foreach collection="item.value" item="token" separator=", ">
    #{token, typeHandler=com.your.package.JsonNodeTypeHandler}
</foreach>

2. 简化参数类型（推荐方案） #

避免在Mapper层直接处理Jackson的JsonNode类型，在Service层将ArrayNode转换为Java原生集合（如List<String>），适配MyBatis默认参数解析逻辑：

// Service层参数转换示例
ArrayNode arrayNode = (ArrayNode) criteriaItem.getValue();
List<String> valueList = arrayNode.elements()
    .map(JsonNode::asText)
    .collect(Collectors.toList());
criteriaItem.setValue(valueList);

转换后Mapper中的foreach可直接遍历List，无需任何自定义TypeHandler，从根源规避类型解析问题。

3. 验证SQL生成与参数绑定 #

开启MyBatis的DEBUG日志，查看生成的Prepared Statement和绑定的参数值，快速定位问题：
在日志配置文件（如logback.xml）中添加：

<logger name="org.apache.ibatis" level="DEBUG"/>

通过日志可直观确认SQL是否正确生成、参数值是否符合预期，区分是参数绑定错误还是SQL逻辑问题。

内容的提问来源于stack exchange，提问作者Inked