103 invalid bound statement (not found)

<think>嗯，用户遇到了MyBatis的Invalid boundstatement错误，也就是找不到映射语句的问题。我需要根据之前的经验和引用内容来想解决方案。首先，这个错误通常是因为MyBatis找不到对应的XML映射文件或者里面的配置有问题。首先，我应该检查XML文件的位置是否正确。根据Maven的标准目录结构，XML文件应该放在src/main/resources下的对应包路径里。如果用户把XML文件放在src/main/java目录下，可能在构建时不会被正确复制到target目录里，导致运行时找不到。所以需要确认资源文件的放置位置，并且检查pom.xml里是否配置了资源过滤，确保XML文件被打包进去。 接下来，检查XML中的namespace是否正确。namespace必须对应Mapper接口的全限定名，包括包名和类名。如果这里有拼写错误，MyBatis就无法将接口方法和XML语句绑定。然后，查看SQL语句的id是否和接口方法名一致。比如，如果接口里有一个selectById方法，XML里的<select>标签的id应该是"selectById"，不一致的话也会导致绑定失败。还有配置文件中mapper的扫描路径是否正确。在Mybatis的配置文件中，<mappers>部分需要正确指定mapper接口或XML的位置。如果使用包扫描，要确保包名正确；如果是手动指定，路径要准确。另外，清理和重新构建项目可能有效。有时候IDE缓存或者旧的构建文件残留会导致问题，执行mvn cleaninstall或者清理项目重新编译，可能解决文件未正确同步的情况。 引用中提到用户将BillMapper.xml挪出又放回，手动建立文件夹，这可能涉及到资源目录的结构问题。可能用户原本的XML文件位置不正确，手动调整后解决了路径问题。所以需要强调资源目录的正确配置，以及在pom.xml中添加资源过滤的配置，确保XML文件被正确识别和打包。最后，如果以上步骤都检查过还是不行，可能需要查看更详细的日志，或者检查是否有重复的mapperid，以及MyBatis的全局配置是否正确。例如，是否启用了驼峰命名映射，或者其他配置问题导致映射失败。</think>### MyBatis "Invalid bound statement (not found)" 解决方案 该错误通常由 **XML映射文件未被正确加载** 或 **接口方法与XML语句绑定失败** 导致。以下是分步排查方案： --- #### 1. 检查XML文件位置 - **标准Maven结构要求**：XML文件应放在`src/main/resources`目录下，且路径需与Mapper接口包名一致。例如： ```plaintext src/main/resources/com/example/mapper/BillMapper.xml ``` - **关键验证步骤**： - 检查`target/classes`目录下是否生成对应XML文件 - 在`pom.xml`中添加资源过滤配置[^1]： ```xml <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` --- #### 2. 验证XML与接口映射关系 - **Namespace一致性检查**：XML文件中`<mapper>`的`namespace`属性必须与Mapper接口全限定名一致 ```xml <mapper namespace="com.example.mapper.BillMapper"> ``` - **ID匹配规则**：SQL语句的`id`必须与接口方法名完全相同 ```xml <select id="selectById" resultType="Bill"> SELECT * FROM bill WHERE id=#{id} </select> ``` --- #### 3. 检查MyBatis配置 - **配置文件扫描路径**：在`mybatis-config.xml`或Spring配置中确认包含以下内容： ```xml <!-- 指定mapper接口包 --> <mappers> <package name="com.example.mapper"/> </mappers> ``` - **多模块项目特别注意**：跨模块引用时需添加`<classpath*:>`前缀： ```yaml mybatis.mapper-locations: classpath*:com/example/**/*.xml ``` --- #### 4. 清理构建缓存 执行以下命令强制刷新资源： ```bash mvn clean install -U ``` 或通过IDE执行： - IntelliJ: Build > Rebuild Project - Eclipse: Project > Clean --- #### 5. 高级排查方法 若仍失败，可尝试： 1. 在XML文件中添加`parameterType`/`resultType`显式声明 2. 检查是否开启`@MapperScan`注解扫描 3. 使用`sqlSession.getConfiguration().getMappedStatementNames()`调试已加载的语句 ---