Invalid bound statement (not found)

记一次问题的解决方法。

在 Spring Boot 中使用 Mybatis 时出现 Invalid bound statement (not found) 错误，在网上一搜通常是让你检查这么几项：

1. 对应方法的 sql 是不是漏写了；
2. Mapper是否被扫描到；
3. 检查报错的那个接口对应的Mapper文件中namespace是否正确；
4. 删除或新增一个空行进行保存，触发重新编译；
5. 解决 jar 包冲突。
6. ……

而我们这个项目的问题现象是这样的：

• 在 idea 上运行没问题；
• 不使用依赖外置也没问题；
• 上一个版本是没问题的，这个版本 mybatis 相关配置都没有进行修改。

只有在打包时使用依赖外置，放在服务器上运行的时候才会出现。
最后通过 remote debug，跟踪发现在

org.mybatis.spring.boot.autoconfigure.MybatisProperties

public Resource[] resolveMapperLocations() {
    return Stream.of(Optional.ofNullable(this.mapperLocations).orElse(new String[0]))
        .flatMap(location -> Stream.of(getResources(location))).toArray(Resource[]::new);
  }

  private Resource[] getResources(String location) {
    try {
      return resourceResolver.getResources(location);
    } catch (IOException e) {
      return new Resource[0];
    }
  }

获取 Resource[] 时使用的参数是配置文件中的 mybatis.mapper-locations，但只获取到了一个以本地引入方式加进来的jar包，在这个jar包中也有个与项目中一样的目录结构存放Mapper。而在这个参数中我们填的是 mapper/*.xml，在讲这个配置值改为 classpath*:mapper/*.xml后程序恢复正常。