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包版本太低。例如，如果您使用mysql 8.0，但使用mysql-connector-java-xxx.jar版本5.1.34，就会出现此错误。下载与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);