关于mybatis的org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):

前言

今天遇到一个很郁闷的错误：org.apache.ibatis.binding.BindingException: Invalid bound
statement (not found)。 奇怪的是我dao接口与mybatis映射文件配置都是正确的，但还是报错

正文

下面，我通过源码去探索一番。这次的探索之旅离不开debug，而项目是maven，所以在探索之前，必须得知道maven如何debug,具体文章在

please click
准备工作差不多了，开始重现错误，报错入下:

定位214行

public SqlCommand(Configuration configuration, Class mapperInterface, Method method) {
      String statementName = mapperInterface.getName() + "." + method.getName();
      MappedStatement ms = null;
      if (configuration.hasStatement(statementName)) {
        ms = configuration.getMappedStatement(statementName);
      } else if (!mapperInterface.equals(method.getDeclaringClass())) { // issue #35
        String parentStatementName = method.getDeclaringClass().getName() + "." + method.getName();
        if (configuration.hasStatement(parentStatementName)) {
          ms = configuration.getMappedStatement(parentStatementName);
        }
      }
      if (ms == null) {
        if(method.getAnnotation(Flush.class) != null){
          name = null;
          type = SqlCommandType.FLUSH;
        } else {
          throw new BindingException("Invalid bound statement (not found): " + statementName);
        }
      } else {
        name = ms.getId();
        type = ms.getSqlCommandType();
        if (type == SqlCommandType.UNKNOWN) {
          throw new BindingException("Unknown execution method for: " + name);
        }
      }
    }

从上面代码看两种途径binding，或者是配置文件，或者是注解。这里配置文件，问题出在configuration.hasStatement(statementName)为false. 进去看一下为什么会false

入下代码

public boolean hasStatement(String statementName, boolean validateIncompleteStatements) {
    if (validateIncompleteStatements) {
      buildAllStatements();
    }
    return mappedStatements.containsKey(statementName);
  }

这里是发生本次异常比较关键的地方了，为什么我会说关键？ 因为我从代码mappedStatements.containsKey(statementName); 中，可以看出2个会发生该异常的情况

1. mappedStatements为{} （空，debug发现，我这里为空）
2. containsKey（statementName），没有找到

mappedStatements为{}

先看第一点。 mappedStatements为什么是空的呢？ 它是在什么时候初始化的呢。

在tomcat启动的时候，进入spring监听函数，里面将去解析spring配置文件，将去加载红框内的资源文件，解析并以key,value的形式缓存在mappedStatements中
具体缓存代码，在下面简单的罗列一下

XmlMapperBuilder方法的parse

public void parse() {
    if (!configuration.isResourceLoaded(resource)) {
      configurationElement(parser.evalNode("/mapper"));
      configuration.addLoadedResource(resource);
      bindMapperForNamespace();
    }

    parsePendingResultMaps();
    parsePendingChacheRefs();
    parsePendingStatements();
  }

进入configurationElement方法，在选择其方法下的

buildStatementFromContext(context.evalNodes("select|insert|update|delete")); 

类层次关系挺复杂的，有闲工夫就花类图理一下，最后找到下面MapperBuilderAssistant类中的addMappedStatement方法

MappedStatement statement = statementBuilder.build();
    configuration.addMappedStatement(statement);

解析完成了，我这次异常罪魁祸首，猜测是上面的红框内路径有问题，所以没缓存mappedStatements中（其实路径之前修改几次，最后是对的，只不过因为我eclipse取消自动编译，没编译，泪奔~）

在看源码的时候，我发现spring，将接口dao，动态代理了一个类，然后存入了IOC，所以我在service层，可以直接使用@Resource注入，至于如何将dao类存放到IOC中，不需要关心

从mappedStatements获取

上面讲过了将mybatis的映射文件缓存在mappedStatements中，具体key为ms.getId().

public void addMappedStatement(MappedStatement ms) {
    mappedStatements.put(ms.getId(), ms);
  }

这里的id规则是，mybatis映射文件的namespace + id,如下

namespace="org.personal.perfect.mpersistent.dao.TestMybatis">
    "map" id="myinfo">
    <select id="selectInformation" parameterType="map" resultType="int">
        select count(1) from information
    select> 
    <select id="selectInformationfor2" parameterType="map" resultType="map">
        select * from information
    select>

    <select id="selectInformationfor3" parameterType="map" resultType="map">
        select * from information where id = #{id}
    select> 
    <select id="selectInformationfor4" parameterType="map" resultType="Information">
        select * from information where id = #{id}
    select> 

而mappedStatements.containsKey(statementName)中的statementName获取的key规则是什么呢

String statementName = mapperInterface.getName() + "." + method.getName();

也就是通过反射，获取类全路径限定名以及方法名，所以这也说明了接口名= namespace 方法名 = id. 赶紧检查一下吧

总结

1.spring与mybatis继承，配置自动扫描的话，赶紧看看资源路径是否对吧
2. dao接口名 = namespace ; 接口方法名 = id.
3. 千万要编译的（3+2 hours，最后突然可行了，泪奔啊）