Invalid bound statement (not found) 错误解决

出现这个错误提示：Invalid bound statement (not found): com.xxx.small_reservior.dao.WaterRainMapper.getWaterRainByRegion，通常表示 MyBatis 框架无法找到与给定的 getWaterRainByRegion 方法匹配的 SQL 映射语句。这种问题通常发生在以下几种情况中：

1. SQL 映射文件中的映射语句未定义

确保在 MyBatis 的 XML 映射文件中，确实有对应的 SQL 语句。例如，如果 WaterRainMapper 中的 getWaterRainByRegion 方法在 XML 文件中没有正确的定义，会导致这个错误。

解决方法：

检查是否在 XML 映射文件中定义了 getWaterRainByRegion 的 SQL 映射语句。比如：

<mapper namespace="com.XXX.WaterRainMapper">

    <select id="getWaterRainByRegion" resultType="com.xxx.small_reservior.model.WaterRain">
        SELECT * FROM water_rain WHERE region = #{region}
    </select>

</mapper>

• id="getWaterRainByRegion" 应该与 WaterRainMapper 接口中的方法名相匹配。
• namespace 属性的值应该与 WaterRainMapper 类的完全限定名一致。

2. MyBatis 配置文件中未加载映射文件

如果 MyBatis 配置文件没有正确加载映射 XML 文件，那么相应的 SQL 映射语句就无法被识别。

解决方法：

确保在 MyBatis 配置文件（mybatis-config.xml 或 Java 配置类）中正确地配置了映射文件。例如：

<configuration>
    <mappers>
        <mapper resource="com/xxx/small_reservior/dao/WaterRainMapper.xml"/>
    </mappers>
</configuration>

或者，如果你使用 Java 配置，可以确保通过 @MapperScan 或手动注册映射器来加载 XML 映射文件。

3. 命名空间不匹配

namespace 元素应该与接口类的完全限定名相同，确保 XML 文件中的命名空间正确。例如，WaterRainMapper.xml 文件的 namespace 应该是 com.xxxx.small_reservior.dao.WaterRainMapper，而不是其他名称。

解决方法：

确认 XML 文件的 namespace 属性与接口类的完全限定名一致。

4. 方法签名不匹配

确保接口中的方法签名与 XML 映射文件中的 id 对应的 SQL 语句完全匹配。方法的参数类型和返回类型需要与 SQL 查询的要求一致。

解决方法：

• 检查 WaterRainMapper 接口中的 getWaterRainByRegion 方法签名。

例如：

public List<WaterRain> getWaterRainByRegion(String region);

确保方法的参数类型和返回类型与 SQL 映射语句的要求匹配。

5. 拼写错误或路径问题

确认没有拼写错误，包括方法名、命名空间、XML 文件路径等。如果路径不对，MyBatis 也无法正确加载映射文件。

解决方法：

• 检查文件名和路径。
• 检查方法名、XML 映射文件中的 SQL id 是否拼写一致。

6. XML 文件没有正确加载到类路径

确保你的 WaterRainMapper.xml 文件被正确地打包并放置在正确的位置，能够被 MyBatis 配置文件或扫描器识别。

解决方法：

• 如果你使用的是 Spring 或 Spring Boot，检查是否配置了正确的类路径扫描和 MyBatis 映射器位置。

  在 Spring Boot 中，你可以使用 @MapperScan 注解来指定 MyBatis 映射器的位置：

  @SpringBootApplication
  @MapperScan("com.xxx.small_reservior.dao")
  public class Application {
      public static void main(String[] args) {
          SpringApplication.run(Application.class, args);
      }
  }

总结

这个错误主要是由于 MyBatis 没有找到对应的 SQL 映射语句，可能是由于以下原因：

1. XML 映射文件中没有对应的 id（SQL 语句）；
2. 配置文件没有加载正确的 XML 映射文件；
3. namespace 或方法签名不匹配；
4. 方法参数或返回类型不正确；
5. 文件路径错误或没有被正确打包。

通过逐一排查这些原因，通常可以解决该问题。