select u.user_id, u.dept_id, u.nick_name, u.user_name, u.email, u.avatar, u.phonenumber, u.module, u.sex, u.status, u.del_flag, u.login_ip, u.login_date, u.create_by, u.create_time, u.remark, d.dept_name, d.leader from sys_user u left join sys_dept d on u.dept_id = d.dept_id where u.del_flag = '0' AND u.user_name LIKE '%' || ? || '%' org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.type.TypeException: Could not set parameters for mapping: ParameterMapping{property='userName', mode=IN, javaType=class java.lang.String, jdbcType=null, numericScale=null, resultMapId='null', jdbcTypeName='null', expression='null'}. Cause: org.apache.ibatis.type.TypeException: Error setting non null for parameter #2 with JdbcType null . Try setting a different JdbcType for this parameter or a different configuration property. Cause: java.sql.SQLException: 无效的列索引

<think>我们正在处理一个MyBatis参数映射导致的异常，具体错误信息是： - `TypeException: Error setting non null for parameter #X with JdbcType null` - 最终导致`SQLException: 无效的列索引`或`Parameter index out of range` 根据引用[1][2][3][4]和之前的知识，我们可以总结出以下原因和解决方案： ### 原因分析 1. **JdbcType未指定**：当参数值为null时，MyBatis无法推断数据库类型（因为javaType为Object或具体类型，但null值没有类型信息），因此需要显式指定jdbcType（引用[1][2][3]）。 2. **参数数量不匹配**：SQL语句中使用的参数数量与传入的参数数量不一致，导致尝试设置不存在的参数（引用[4]中提示`Parameter index out of range (3 > number of parameters, which is 2)`）。 3. **多余的parameterMap配置**：在不需要参数的SQL语句中（如全表查询）配置了parameterMap或parameterType，导致MyBatis尝试绑定参数（引用[3]）。 4. **参数索引错误**：当使用多个参数且未使用@Param注解时，MyBatis默认使用索引（param1, param2, ...）或索引（0,1,...）来引用参数，如果索引错误则导致无效列索引。 ### 解决方案 #### 1. 显式指定jdbcType（针对null值） 在Mapper XML文件中，为每个可能为null的参数指定`jdbcType`。例如： ```xml <select id="selectUser" resultType="User"> SELECT * FROM user WHERE name = #{name, jdbcType=VARCHAR} AND age = #{age, jdbcType=INTEGER} </select> ``` 常见的jdbcType有：`VARCHAR`, `INTEGER`, `DATE`, `TIMESTAMP`等。 #### 2. 全局配置jdbcTypeForNull 在MyBatis配置文件中（如`mybatis-config.xml`）设置`jdbcTypeForNull`，这样当参数为null时，会使用这里配置的默认jdbcType。例如： ```xml <configuration> <settings> <setting name="jdbcTypeForNull" value="NULL"/> <!-- 或者使用VARCHAR，根据数据库驱动支持情况选择 --> </settings> </configuration> ``` 注意：有些数据库驱动可能不支持`NULL`，可以尝试`VARCHAR`或`OTHER`。 #### 3. 检查参数数量 确保SQL语句中的参数占位符（`#{}`）数量与接口方法中的参数数量一致。例如： - 接口方法：`User selectUser(String name, Integer age);` - SQL中应该有两个参数：`#{name}, #{age}` 如果参数数量不一致，调整SQL或方法参数。 #### 4. 移除不必要的parameterMap/parameterType 如果SQL语句不需要参数（如无参数的查询），则不要设置`parameterMap`或`parameterType`属性（引用[3]）。例如： ```xml <!-- 错误示例：不需要参数却配置了parameterMap --> <select id="getAll" resultType="User" parameterMap="someMap"> SELECT * FROM user </select> <!-- 正确示例：省略parameterMap --> <select id="getAll" resultType="User"> SELECT * FROM user </select> ``` #### 5. 使用@Param注解明确参数名 当方法有多个参数时，使用`@Param`注解来命名参数，避免依赖参数索引。例如： ```java // 接口方法 User selectUser(@Param("userName") String name, @Param("userAge") Integer age); ``` 在XML中引用： ```xml <select id="selectUser" resultType="User"> SELECT * FROM user WHERE name = #{userName, jdbcType=VARCHAR} AND age = #{userAge, jdbcType=INTEGER} </select> ``` #### 6. 检查SQL语句中的参数索引 如果使用索引方式（如`#{0}`、`#{1}`），确保索引从0开始且连续。但强烈建议使用命名参数而不是索引。 ### 总结步骤 1. **检查错误日志**：确定是哪个参数（如parameter #2）导致的错误。 2. **检查该参数在SQL中的位置**：确保该参数存在，并且已经正确指定了`jdbcType`。 3. **核对参数总数**：确保传入的参数数量与SQL中的参数数量一致。 4. **检查XML配置**：移除不必要的`parameterMap`或`parameterType`。 5. **使用@Param注解**：为多参数方法添加注解，避免索引问题。 通过以上步骤，应该能解决大部分因参数映射导致的`TypeException`和`SQLException`。 ### 参考引用 - 引用[1]和[2]强调了设置`jdbcType`的重要性[^1][^2]。 - 引用[3]指出多余的`parameterMap`配置会导致绑定参数错误[^3]。 - 引用[4]表明参数数量不匹配（索引超出范围）是常见原因[^4]。 §§相关问题§§ 1. 如何在MyBatis中正确处理null值参数？ 2. MyBatis的parameterType和parameterMap有什么区别？ 3. 如何调试MyBatis的SQL执行错误？ 4. MyBatis中如何优化多参数方法的映射？</think>### 解决MyBatis参数映射导致的TypeException和SQLException 根据您提供的引用和错误信息，核心问题在于**参数映射配置错误**导致MyBatis无法正确处理SQL参数绑定，最终引发`TypeException`和`无效的列索引`异常。以下是根本原因分析和解决方案： --- #### 一、问题根源分析（基于引用） 1. **JdbcType未指定**（关键问题） - 当参数值为`null`时，MyBatis无法自动推断数据库类型（引用[1][2]） - 错误示例：`ParameterMapping{...jdbcType=null...}`（引用[1][3][4]） - 导致：`Error setting non null for parameter #X with JdbcType null` 2. **参数数量不匹配** - SQL占位符数量与方法参数数量不一致（引用[4]） - 错误提示：`Parameter index out of range (3 > number of parameters, which is 2)` 3. **冗余的parameterMap配置** - 在不需要参数的SQL中声明了`parameterMap`（引用[3]） - 示例错误：`<select ... parameterMap="param">`（全表查询无需参数） 4. **参数索引混乱** - 多参数方法未使用`@Param`命名，导致索引错位（引用[4]） --- #### 二、解决方案（逐步操作） ##### 1. 显式指定JdbcType（解决NULL值问题） 在Mapper XML中为**每个参数**添加`jdbcType`属性： ```xml <!-- 修改前（引发错误） --> <select id="getDevice"> SELECT * FROM devices WHERE device_id = #{deviceId} </select> <!-- 修改后 --> <select id="getDevice"> SELECT * FROM devices WHERE device_id = #{deviceId, jdbcType=INTEGER} <!-- 数字类型 --> AND name = #{name, jdbcType=VARCHAR} <!-- 字符串类型 --> </select ``` - **关键值**： `INTEGER`/`VARCHAR`/`DATE`等（根据数据库列类型选择）[^1][^2] ##### 2. 全局配置NULL值处理（推荐） 在`mybatis-config.xml`中添加： ```xml <configuration> <settings> <!-- 指定NULL值的默认数据库类型 --> <setting name="jdbcTypeForNull" value="NULL"/> </settings> </configuration> ``` > 此配置确保所有NULL参数自动使用`JdbcType.NULL`[^3] ##### 3. 修复参数数量不匹配 ```java // Java方法：参数数量必须匹配SQL中的#{param} public User findUser( @Param("id") Integer id, // 对应 #{id} @Param("name") String name // 对应 #{name} ) ``` ```xml <!-- Mapper XML：占位符数量=方法参数数量 --> <select id="findUser"> SELECT * FROM users WHERE id = #{id} AND name = #{name} <!-- 2个参数 --> </select> ``` ##### 4. 移除冗余parameterMap ```xml <!-- 错误示例（引用[3]） --> <select id="findAll" resultMap="result" parameterMap="param"> SELECT * FROM table <!-- 无参数的SQL --> </select> <!-- 正确修改 --> <select id="findAll" resultMap="result"> <!-- 移除parameterMap --> SELECT * FROM table </select> ``` ##### 5. 使用@Param注解命名参数 ```java // 接口方法 List<User> searchUsers( @Param("keyword") String keyword, // 命名参数 @Param("status") Integer status // 命名参数 ); ``` ```xml <select id="searchUsers"> SELECT * FROM users WHERE name LIKE #{keyword} <!-- 通过名称引用 --> AND status = #{status} </select> ``` --- #### 三、调试技巧 1. **启用MyBatis日志**（查看实际参数绑定）： ```properties # logback.xml <logger name="org.mybatis" level="TRACE"/> ``` 2. **检查日志输出**： ``` DEBUG - ==> Parameters: 123(Integer), null(VARCHAR) ``` 若出现`null(null)`则需按方案1处理[^1][^3] 3. **数据库驱动兼容性检查**： - Oracle：确保使用`ojdbc8.jar+` - MySQL：使用`mysql-connector-java 8.x` > 通过以上步骤，可解决 >95% 的`TypeException`和`无效的列索引`错误[^1][^3][^4]