Maven项目mybatis Invalid bound statement (not found)解决方法

解决MyBatis Invalid Bound Statement
本文介绍了解决MyBatis开发中遇到的Invalid Bound Statement问题的方法,包括遵循的规范和Maven项目的配置调整。

最近因为工作需要,要学习mybatis框架。在添加好一些依赖之后,通过mybatis进行数据库的crud操作。但是在测试的时候总是报mybatis:Invalid bound statement (not found)。在网上搜索了好久,最后终于发现了问题的所在,现在把它记录下来,供大家参考:

在mapper代理的开发中,程序员需要遵守一些规范,mybatis才能实现mapper接口的代理对象。
它的规范如下:

  • mapper.xml的namespace要写所映射接口的全称类名。
  • mapper.xml中的每个statement的id要和接口方法的方法名相同
  • mapper.xml中定义的每个sql的parameterType要和接口方法的形参类型相同
  • mapper.xml中定义的每个sql的resultType要和接口方法的返回值的类型相同
  • mapper.xml要和对应的mapper接口在同一个包下
  • mapper.xml的命名规范遵守: 接口名+Mapper.xml

如果以上检查完毕,项目都遵守了上述的规范,而且你的项目是Maven项目。但是运行程序还是会出现Mybatis invalid bound statement(not found)的问题,这个时候就需要修改pom.xml文件了。在pom.xml中添加如下的代码:

    <build>    
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <!-- 此配置不可缺,否则mybatis的Mapper.xml将会丢失 -->
                <includes>
                    <include>**/*.xml</include>
                </includes>
            </resource>
            <!--指定资源的位置-->
            <resource>
                <directory>src/main/resources</directory>
            </resource>
        </resources>
    </build>

将以上代码添加到pom.xml中,运行项目,问题解决。

<think>好的,我现在需要帮助用户解决MyBatis中出现的“Invalid boundstatement notfound”错误,具体是在com.ruoyi.system.mapper下的患者信息Mapper.select患者信息List方法。首先,我得回忆一下常见的导致这个错误的原因,并结合用户提供的引用内容来逐一分析。用户提到引用了三个站内引用,其中引用1提到XML配置路径是否正确,引用2说明MappedStatement的id生成规则,引用3则涉及配置文件和资源路径的问题。根据这些信息,我应该从这几个方面入手。 首先,检查XML文件路径是否正确。根据引用1和引用3,MyBatis的XML文件需要放在正确的资源目录下,通常是在src/main/resources中,并且目录结构需要与Mapper接口的包名一致。如果用户把XML文件放在src/main/java目录下,可能需要配置Maven来包含这些文件,如引用3中的resource配置所示。因此,我需要建议用户检查XML文件的位置,并确保Maven正确打包了这些文件。其次,确认XML中的namespace和方法id是否正确。根据引用2,MappedStatement的id是由Mapper接口的全限定名和方法名拼接而成,所以必须完全匹配。用户的方法名是select患者信息List,可能存在中文字符的问题,或者方法名与XML中的id不一致。需要检查Mapper接口中的方法名是否与XML中的id对应,特别是中文字符是否被正确处理,或者是否存在空格或拼写错误。 接下来,检查MyBatis配置是否正确。引用3提到application.properties或application.yml中的配置是否正确,特别是mybatis.mapper-locations是否指向了XML文件的位置。如果用户使用的是MyBatis-Plus,可能需要确认配置类是否添加了@MapperScan注解,或者是否正确配置了SqlSessionFactoryBean。 另外,清理和重新构建项目也很重要。有时候编译后的文件可能没有正确生成,导致XML文件未被包含进去,清理项目并重新构建可以解决这个问题。 最后,如果以上步骤都没问题,可能需要查看生成的Mapper代理类,或者启用MyBatis的日志来查看具体的加载情况,帮助定位问题所在。总结起来,应该分步骤引导用户检查XML路径、命名是否正确,配置是否合理,并进行必要的清理和验证。同时,要注意用户的方法名中使用了中文,可能引发潜在的问题,需要特别提醒用户检查这部分内容。</think>### 解决MyBatis "Invalid bound statement not found" 错误的分步指南 #### 1. **检查XML文件路径和命名规范** - **XML文件位置**:确保`患者信息Mapper.xml`文件位于`src/main/resources`目录下,且路径与Mapper接口包名一致。例如: ``` src/main/resources/com/ruoyi/system/mapper/患者信息Mapper.xml ``` - **Maven资源配置**:若XML文件放在`src/main/java`中,需在`pom.xml`中添加资源包含配置: ```xml <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> ``` 引用示例配置[^3]。 #### 2. **验证XML与接口方法映射关系** - **namespace匹配**:XML文件中`namespace`属性必须对应Mapper接口的全限定名: ```xml <mapper namespace="com.ruoyi.system.mapper.患者信息Mapper"> ``` - **方法ID一致性**:XML中SQL语句的`id`必须与Mapper接口方法名**完全一致**。例如: ```xml <select id="select患者信息List" resultType="..."> SELECT * FROM 患者表 </select> ``` 注意中文字符需避免空格或拼写错误,如`select患者信息List`与接口方法名是否一致[^2]。 #### 3. **检查MyBatis配置** - **配置文件路径**:在`application.yml`或`application.properties`中确认`mybatis.mapper-locations`指向正确路径: ```yaml mybatis: mapper-locations: classpath*:com/ruoyi/system/mapper/**/*.xml ``` 若使用MyBatis-Plus,配置项应为`mybatis-plus.mapper-locations`[^3]。 - **注解扫描**:在Spring Boot启动类或配置类中添加`@MapperScan`注解: ```java @MapperScan("com.ruoyi.system.mapper") ``` #### 4. **清理并重新构建项目** - 执行Maven命令清理缓存并重新编译: ```bash mvn clean install ``` - 检查编译后的`target/classes`目录是否包含XML文件。 #### 5. **排查特殊字符影响** - **中文方法名风险**:部分IDE或编译工具对中文字符支持不稳定,建议将方法名改为英文(如`selectPatientList`),并在XML中同步修改`id`。 - **编码问题**:确保XML文件保存为UTF-8格式,避免乱码导致解析失败。 #### 6. **启用MyBatis日志定位问题** - 在配置文件中添加日志级别配置: ```yaml logging: level: org.mybatis: DEBUG ``` - 观察启动日志中是否加载了目标XML文件,及是否报出具体SQL映射异常。 --- ### 相关问题 1. **如何避免MyBatis中Mapper接口与XML文件的命名冲突?** 2. **MyBatis-Plus与原生MyBatis在配置上有哪些差异?** 3. **为什么推荐将XML文件放在`resources`目录而非`java`目录?** --- ### 引用说明 [^1]: XML文件路径错误或未正确打包会导致映射丢失。 [^2]: Mapper接口方法名与XML的`id`必须严格一致,否则无法生成`MappedStatement`。 [^3]: MyBatis-Plus需单独配置`mapper-locations`,且资源路径需通过Maven显式声明。
评论 10
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值