在使用 MyBatis 时，遇到 argument type mismatch 错误通常意味着传递给 SQL 映射方法的参数类型与映射文件中预期的类型不匹配。这个问题通常出现在 Mapper 方法 的参数与 SQL 映射文件 中的 SQL 语句参数类型不一致的情况。

常见原因和解决方案：

1. 方法参数类型与 SQL 映射文件中的参数类型不匹配

  • 问题描述：比如，Mapper 方法的参数类型是 String，但在 SQL 映射文件中的参数是 Integer，导致 MyBatis 无法进行正确的参数映射。
  • 解决方案：
    • 确保 Mapper 方法的参数类型与 SQL 映射文件中的 <select>, <insert>, <update>, <delete> 等标签中的 parameterType 一致。
    • 例如，下面的 SQL 映射文件：<select id="getUserById" parameterType="java.lang.Integer" resultType="com.example.User"> SELECT * FROM users WHERE id = #{id} </select> 对应的 Mapper 方法应该是：public User getUserById(Integer id); 如果参数类型不匹配（例如，id 为 String），MyBatis 就会抛出 argument type mismatch 错误。

2. 多个参数类型不一致

  • 问题描述：当方法有多个参数时，若没有正确使用 @Param 注解指定参数名称，MyBatis 无法根据名称找到正确的参数，可能导致类型不匹配的错误。
  • 解决方案：
    • 使用 @Param 注解明确指定每个参数的名称。例如，若 Mapper 方法如下：public User getUserByNameAndAge(String name, Integer age); 对应的 SQL 映射文件应该是：<select id="getUserByNameAndAge" parameterType="map" resultType="com.example.User"> SELECT * FROM users WHERE name = #{name} AND age = #{age} </select> 但是，如果没有明确指定 name 和 age，MyBatis 会不知道如何正确地匹配参数。此时需要在方法参数上加上 @Param 注解，如下所示：public User getUserByNameAndAge(@Param("name") String name, @Param("age") Integer age);

3. 类型别名问题

  • 问题描述：MyBatis 使用了类型别名（alias）来简化类型引用，如果类型别名配置错误，也可能导致类型匹配问题。
  • 解决方案：
    • 确保你在 mybatis-config.xml 或映射文件中正确配置了类型别名。如果你使用了别名，确保它与映射文件中的类型一致。<typeAliases> <typeAlias alias="User" type="com.example.User"/> </typeAliases> 这样，你可以在 SQL 映射文件中使用 User 作为类型，而不是全路径的 com.example.User。

4. 使用 Map 参数时没有设置正确的参数类型

  • 问题描述：如果 Mapper 方法的参数是 Map 类型，确保映射文件中的 parameterType="map" 或者使用 @Param 注解。
  • 解决方案：
    • 如果方法签名为：public List<User> getUsers(Map<String, Object> params); 对应的 SQL 映射文件应该是：<select id="getUsers" parameterType="map" resultType="com.example.User"> SELECT * FROM users WHERE name = #{name} AND age = #{age} </select> 在这个例子中，你可以在调用时通过 Map 传递 name 和 age。Map<String, Object> params = new HashMap<>(); params.put("name", "John"); params.put("age", 30); List<User> users = userMapper.getUsers(params);

5. 复杂类型的嵌套映射问题

  • 问题描述：在使用复杂对象映射时（如嵌套的 List 或对象），可能会出现类型不匹配的问题。
  • 解决方案：
    • 使用 @Results 和 @Result 注解来指定复杂类型的映射关系，确保字段名称和类型一致。例如，如果你有如下的对象：public class User { private String name; private Address address; } public class Address { private String city; private String street; } 对应的 SQL 映射文件：<select id="getUserWithAddress" resultMap="userResultMap"> SELECT u.name, a.city, a.street FROM users u JOIN address a ON u.address_id = a.id </select> <resultMap id="userResultMap" type="com.example.User"> <id property="name" column="name"/> <association property="address" javaType="com.example.Address"> <result property="city" column="city"/> <result property="street" column="street"/> </association> </resultMap> 这样，MyBatis 会正确地映射 User 类和 Address 类。

总结

  1. 检查方法参数与 SQL 映射文件中的参数类型是否匹配。
  2. 使用 @Param 注解明确指定多个参数的名称。
  3. 检查类型别名配置，确保使用别名时类型一致。
  4. 在 Map 参数中正确使用 parameterType="map"。
  5. 对于复杂对象，使用 @Results 和 @Result 进行手动映射。

通过这些检查，你应该能够解决 argument type mismatch 问题。如果你依然遇到困难，检查 MyBatis 的日志输出可能会提供更多有用的信息。