mybatis使用时出现的错误合集

Cause: org.xml.sax.SAXParseException; lineNumber: 2; columnNumber: 6; 不允许有匹配 “[xX][mM][lL]” 的处理指令目标。

出现该错误的主要原因是xml文件的配置问题，在第一行不允许有空格或空行。

将空行删去就可以了。

Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.cj.jdbc.Driver（com.mysql.jdbc.Driver）

出现该问题的原因是mysql驱动的jar包版本太低，如你使用8.0的mysql，但使用5.1.34版本的mysql-connector-java-xxx.jar就会出现该错误，下载匹配mysql版本的jar包即可。

如我用的maven配置的5.1.34版本的mysql驱动：

<dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.34</version>
    </dependency>

会报错：

将配置文件中的mysql文件改为8.0.11版本后就不会可以了：

成功：

Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: org.apache.ibatis.binding.BindingException: Type interface mapper.UserMapper is already known to the MapperRegistry.

原因：在mybatis的配置文件中映射配置文件重复配置，如下图，使用mapper标签配置了映射配置文件，又用包扫描加载了配置文件所在的包，重复了。
解决方案：删除任意一个即可。

如图注释掉一个成功运行：

Error querying database. Cause: org.apache.ibatis.binding.BindingException: Parameter ‘username’ not found. Available parameters are [arg1, arg0, param1, param2]

当出现此类错误的原因是：mapper代理的映射接口的实现方法参数传递出现问题。

 List<User> selectTotal(String username,String password);

当传递多个参数时，需要用@param实现。使用如下方法就可以了。

 List<User> selectTotal(@Param("username") String username,@Param("password") String password);