Mybatis报错:Parameter index out of range (1 > number of parameters, which is 0) 解决方法

Mybatis报错:Parameter index out of range (1 > number of parameters, which is 0) 解决方法


操作:插入数据报错,参数索引超出范围

实体类

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Day60s implements Serializable {

    // ID
    private Integer id;

    // 内容
    private List<String> infos;

    // 创建时间
    private String createDatetime;

    // 逻辑删除(0:可用,1:失效)
    private Integer deleted;

    // 描述
    private String remark;

}

Mapper接口

/**
     * 插入一条信息
     * @param arg
     * @return
     */
    Integer insertOne(Day60s arg);

Impl实现类

/**
     * 插入一条信息
     * @param arg
     * @return
     */
    @Override
    public ResultMap<Day60s> insertOne(Day60s arg) throws Exception {
        ResultMap<Day60s> result = ResultMap.getError();
		
		// 调用Mapper层
        Integer successNum = mapper.insertOne(arg);

        if(successNum > 0) {
            result = ResultMap.getSuccess(arg);
            return result;
        }

        return result;
    }

xml配置文件

<insert id="insertOne" parameterType="Day60s" useGeneratedKeys="true" keyProperty="id">
        insert into day60s
        <trim prefix="(" suffix=")" suffixOverrides=",">
            <if test="infos != null and infos != ''">
                `infos`,
            </if>
            <if test="createDatetime != null and createDatetime != ''">
                `createDatetime`,
            </if>
            <if test="remark != null and remark != ''">
                `remark`
            </if>
        </trim>
        <trim prefix="values (" suffix=")" suffixOverrides=",">
            <if test="infos != null and infos != ''">
                <foreach collection="infos" item="item" index="index" open="'[" close="]'" separator=",">#{item}</foreach>
            </if>
            <if test="createDatetime != null and createDatetime != ''">
                #{createDatetime},
            </if>
            <if test="remark != null and remark != ''">
                #{remark}
            </if>
        </trim>
    </insert>
collection="infos",传参不一定非要list、map,这里传参是实体类,infos为实体类中的属性(List<String> infos)

测试接口

在这里插入图片描述

{
    "id": null,
    "infos": [1,2,3,4,5,6,"abcd","喝咖啡哈萨克"],
    "createDatetime": null,
    "deleted": 0,
    "remark": null
}

异常信息

Day60sMapper.insertOne : ==>  Preparing: insert into day60s ( `infos` ) values ( '[?,?,?,?,?,?,?,?]' )

java.sql.SQLException: Parameter index out of range (1 > number of parameters, which is 0).

原因分析

SQL语句分析,带入以上json中infos传递的参数

// 异常报错信息
insert into day60s ( `infos` ) values ( '[?,?,?,?,?,?,?,?]' )

// 执行的SQL语句
insert into day60s ( `infos` ) values ( '['1','2','3','4','5','6','abcd','喝咖啡哈萨克']' )

// 正常的语句
insert into day60s ( `infos` ) values ( ? )

把执行的SQL拿去执行一下就知道这是不可能成功的(一个参数,对应多个值是不可以的)
在这里插入图片描述

!!!最主要的问题是就出现在#{}
<foreach collection="infos" item="item" index="index" open="'[" close="]'" separator=",">#{item}</foreach>


<foreach collection="infos" item="item" index="index" open="'[" close="]'" separator=",">${item}</foreach>
这两句的区别就在于一个是#{},一个是${}
#{}用于占位 ==> ?被解析后带引号‘’
${}用于替换 ==> 被解析后不带引号
官方文档

${column} 会被直接替换,而 #{value} 会使用 ? 预处理。 这样,就能完成同样的任务:

@Select(“select * from user where ${column} = #{value}”)
User findByColumn(@Param(“column”) String column, @Param(“value”) String value);
<think>好的,用户遇到了MyBatis的“Parameter index out of range (1 > number of parameters, which is 0)”错误,需要我帮忙解决。先回顾一下用户提供的引用内容和之前的对话。 用户之前给出的引用[1]和[2]提到了类似的问题,主要是参数索引超出范围,可能涉及参数数量不匹配或参数未正确绑定。之前的回答中,我已经解释了参数名称不匹配、@Param注解的使用、参数数量问题以及动态SQL的注意事项。现在用户再次提问,需要更具体的解决方案,特别是针对参数数量为0的情况。 首先,错误信息中的“number of parameters, which is 0”意味着MyBatis在执行SQL时没有接收到任何参数,但SQL语句中却引用了参数(比如#{param})。这种情况可能有几个原因: 1. **方法参数未正确传递**:可能Mapper接口方法被调用时没有传入任何参数,或者在动态代理过程中参数丢失。 2. **XML中的参数占位符错误**:比如错误地使用了${}而不是#{},或者在SQL语句中错误地添加了引号导致参数被当作字符串处理。 3. **集合/数组类型处理不当**:例如在使用foreach遍历集合时,如果传入的集合为空或未正确指定类型,可能导致参数未被识别。 4. **参数类型未指定JdbcType**:当参数为null时,MyBatis可能无法推断JdbcType,需要显式指定。 引用[2]中的例子显示,用户尝试插入数据时,虽然实体类的infos字段有值,但生成的SQL语句中的占位符被包裹在引号中,导致MyBatis认为是一个字符串而非参数列表,因此实际参数数量为0。这种情况下,需要检查XML映射文件中的SQL语句是否正确使用了#{},并且没有错误地添加额外的引号。 接下来需要针对这些可能的原因逐一分析,给出解决方案。例如,对于参数未传递的情况,需要检查Mapper接口方法的调用是否正确传参;对于XML中的占位符问题,需要修正SQL语句,确保参数正确绑定;对于集合类型,需要正确使用foreach标签并指定参数类型。此外,显式指定JdbcType也是一个常见的解决方法,特别是在参数可能为null的情况下。 最后,用户可能还需要了解如何预防此类错误,比如在编写XML时使用正确的语法,以及在测试时如何验证参数是否正确绑定。需要确保回答结构清晰,逐步引导用户检查各个可能的问题点,并提供具体的代码示例,如修正后的Mapper接口和XML配置,以及参数传递的正确方式。</think>--- ### MyBatis中“Parameter index out of range (1 > number of parameters, which is 0)解决方案 此错误表明**SQL语句包含占位符(如`#{param}`),但实际未接收到任何参数**,以下是具体原因及解决方法: --- #### 1. **参数未正确传递**(核心原因) - **问题表现** XML中引用了参数(如`#{param}`),但调用Mapper方法时未传入参数,或方法参数被错误处理[^2]。 - **解决方案** - **检查Mapper接口与调用代码** 确保方法调用时参数传递正确: ```java // 正确示例:传入参数 day60sMapper.insertOne(entity); // entity必须为非空对象 ``` - **验证Mapper接口定义** 接口方法需明确接收参数: ```java // 错误示例:方法无参数 void insertOne(); // 正确示例:添加参数 void insertOne(@Param("entity") Day60sEntity entity); ``` --- #### 2. **XML中参数占位符错误** - **问题分析** 常见于集合类型参数处理错误,例如: ```xml <!-- 错误示例:占位符被单引号包裹,导致参数被识别为字符串 --> <insert id="insertOne"> INSERT INTO day60s (`infos`) VALUES ('[#{item}, #{item}, ...]') </insert> ``` - **解决方案** 使用`<foreach>`标签正确处理集合参数,**避免手动拼接引号**: ```xml <insert id="insertOne"> INSERT INTO day60s (`infos`) VALUES ( <foreach collection="entity.infos" item="item" separator="," open="[" close="]"> #{item,jdbcType=VARCHAR} </foreach> ) </insert> ``` --- #### 3. **参数类型不匹配** - **问题表现** 若参数为`null`且未指定`jdbcType`,MyBatis无法推断类型[^1]。 - **解决方案** 显式指定`jdbcType`(尤其是基本类型): ```xml <!-- 示例:处理可能为null的参数 --> <insert id="insertOne"> INSERT INTO day60s (`remark`) VALUES (#{entity.remark,jdbcType=VARCHAR}) </insert> ``` --- #### 4. **动态SQL逻辑错误** - **问题分析** 使用`<if>`标签时,若所有条件均不满足,SQL语句可能不含任何参数占位符,但MyBatis仍尝试绑定参数。 - **解决方案** 添加默认参数或验证动态条件: ```xml <insert id="insertOne"> INSERT INTO day60s <trim prefix="(" suffix=")" suffixOverrides=","> <if test="entity.infos != null"> `infos`, </if> <!-- 必须至少包含一个非空字段 --> <if test="true"> `deleted` </if> </trim> VALUES (...) </insert> ``` --- ### 示例修正(引用[^2]问题) **原错误SQL**: ```xml <!-- 错误:'[?,?,...]'被识别为字符串而非参数列表 --> INSERT INTO day60s (`infos`) VALUES ('[?,?,?,?,?,?,?,?]') ``` **修正后XML**: ```xml <insert id="insertOne"> INSERT INTO day60s (`infos`) VALUES ( <foreach collection="entity.infos" item="item" separator="," open="[" close="]"> #{item,jdbcType=VARCHAR} </foreach> ) </insert> ``` **调用代码**: ```java Day60sEntity entity = new Day60sEntity(); entity.setInfos(Arrays.asList(1,2,3,4,5,6,"abcd","喝咖啡哈萨克")); day60sMapper.insertOne(entity); // 确保参数非空 ``` --- ### 关键验证步骤 1. **检查SQL日志** 观察生成的SQL是否包含`?`占位符(而非硬编码值)。 2. **启用MyBatis调试日志** 在`log4j.properties`中添加: ```properties log4j.logger.org.apache.ibatis=DEBUG log4j.logger.java.sql=DEBUG ``` 3. **单元测试验证** 使用JUnit测试参数传递逻辑。 --- ### 相关问题 1. MyBatis如何自动映射集合类型参数? 2. 动态SQL中`<foreach>`标签的常见用法有哪些? 3. 如何通过日志分析MyBatis参数绑定过程?
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值