mybatis-springboot Invalid bound statement (not found)

<think>嗯，用户遇到了MyBatis和Spring Boot集成时的'Invalid bound statement (not found)'错误。我需要根据提供的引用和之前的经验来整理解决方案。首先，这个错误通常和Mapper接口与XML文件的绑定有关。让我先回忆一下常见的可能原因。 首先，检查XML文件是否被打包到类路径下。用户可能在开发环境没问题，但打包时没有包含XML文件，导致运行时找不到。比如Maven项目需要在pom.xml中配置资源包含，引用1和4提到了mapper-locations的配置，可能需要检查资源路径是否正确。 然后，确认接口名和XML文件名是否一致。引用2指出接口名和XML文件名不一致会导致这个问题，所以需要检查命名是否符合MyBatis的要求，比如UserMapper接口对应UserMapper.xml。 接下来，检查配置文件的路径是否正确。用户可能在application.yml或application.properties中配置了错误的mapper-locations路径，比如引用1中的配置是否正确，是否使用了classpath*:来包含所有模块的XML文件。 另外，MyBatis Plus的特殊配置需要注意，引用3提到必须使用MybatisSqlSessionFactory而不是默认的SqlSessionFactory，这可能是一个容易忽略的点。如果用户用了MyBatis Plus，可能需要调整配置类。 还有，检查XML中的namespace和方法id是否正确。比如namespace必须对应接口的全限定名，而SQL语句的id要和接口方法名一致。用户可能在这里有小错误，比如拼写错误或大小写问题。 此外，自动驼峰命名的配置也可能影响字段映射，引用5提到需要确认mybatis-plus.configuration.map-underscore-to-camel-case的设置是否正确，虽然这可能不是直接导致Bound Statement错误的原因，但也需要检查。 可能还需要检查是否在启动类添加了@MapperScan注解，确保MyBatis能扫描到Mapper接口。如果用户没有配置，或者扫描路径不正确，也会导致接口无法注册。 最后，建议用户清理并重新构建项目，有时候IDE缓存可能导致文件没有正确更新，比如Maven的clean和重新打包步骤。</think>### MyBatis与Spring Boot集成时出现"Invalid bound statement (not found)"的解决方案 #### 一、核心排查步骤 1. **检查XML文件打包情况** - 确认`mapper.xml`文件位于`src/main/resources/mapper`目录 - 在`pom.xml`中添加资源过滤配置： ```xml <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` - 检查打包后的JAR文件是否包含XML文件[^1][^4] 2. **验证接口与XML命名一致性** - Mapper接口名必须与XML文件名完全一致（区分大小写） - 示例： ```java public interface UserMapper { /*...*/ } ``` 对应XML文件应为`UserMapper.xml`[^2][^5] 3. **检查MyBatis配置** ```yaml mybatis: mapper-locations: classpath*:/mapper/**/*.xml type-aliases-package: com.example.entity ``` 使用`classpath*:`确保多模块扫描，注意路径层级符号`**`表示递归查找[^1][^4][^5] 4. **验证XML文件内容** ```xml <!-- UserMapper.xml --> <mapper namespace="com.example.mapper.UserMapper"> <select id="selectById" resultType="User"> SELECT * FROM user WHERE id = #{id} </select> </mapper> ``` - `namespace`必须为接口全限定名 - `id`必须与方法名完全一致[^2] #### 二、MyBatis Plus特殊配置 ```java @Configuration public class MybatisConfig { @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); factory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath*:/mapper/**/*.xml")); return factory.getObject(); } } ``` 必须使用`MybatisSqlSessionFactoryBean`替代默认工厂[^3] #### 三、辅助验证手段 1. **启动类添加扫描注解** ```java @SpringBootApplication @MapperScan("com.example.mapper") public class Application { /*...*/ } ``` 2. **检查IDE设置** - 确认IDEA的"Settings -> Editor -> File Encodings"中配置为UTF-8 - 清理缓存：File -> Invalidate Caches 3. **字段映射验证** ```yaml mybatis-plus: configuration: map-underscore-to-camel-case: true ``` 确保数据库字段与实体类命名规范匹配