MyBatis 常见错误-阿里云开发者社区

MyBatis 常见错误

2020-08-20 2632

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 为初学者准备的常见MyBatis 异常汇总，持续完善中

11 错误汇总

PersistenceException 持久化异常...

BuilderException 构建异常 ...

ReflectionException 反射异常...

BindingException（数据捆绑）注入异常...

SQLSyntaxErrorException SQL 语句错误异常

ExpressionSyntaxException 表达式语法错误

11.1 Could not find resoure

资源未找到所导致的异常..

getResource时资源路径写错了 或者是主配置文件 mapper 中的resource写错了

11.2 Cannot find class

没有找到class...

去看看你包导入了吗或者看看你类名是不是写错了。

11.3 Mapped Statements collection does not contain value for ...

Mapped Statements collection中含指定内容 (key、value) 使用getMepperStatement()方法来获取不存在的的statement id 时会报此类异常

去看看statement id 是否存在于配置文件

例: Mapped Statements collection does not contain value for 123.electAll

值 123.electAll 在 Mapped Statements collection(映射声明集) 中不存在

11.4 Type ${interface} is not known to the MapperRegistry.

所指定的接口类型在映射仓库中不存在 使用动态代理获取指定接口时会遇到这种异常

你写的mapper配置文件是否对应接口，去看看 mapper 的namespace

例: Type interface com.mybatis.dao.UserMapper is not known to the MapperRegistry.

接口类型 com.mybatis.dao.UserMapper 不存在于映射仓库

11.5 Type ${interface} is already known to the MapperRegistry.

所指定的接口类型在映射仓库中已存在

添加映射仓库中不存在的接口类型

11.6 Invalid bound statement (not found): ...

非法范围声明(未找到) 使用动态代理执行接口方法时会遇到这种异常

检查 mapper 文件中CRUD id 是否与接口方法名相同。

例: Invalid bound statement (not found): com.mybatis.dao.UserMapper.selectAll

指定的 com.mybatis.dao.UserMapper.selectAll 在声明范围中不存在

11.7 Mapping is missing column attribute for property ...

使用resultMap 在映射属性中找不到 column 属性 ... 使用resultMap映射类时，未指定cloumn 会抛出此异常

写出 column 属性即可

例：

 <resultMap type="User" id="User">
     <id />
     <result property="id" />
 </resultMap>

上面两种都会抛出此异常

11.8 Cannot determine value type from string '${str}'

无法从字符串${str}中确定值类型

cloumn 映射至 POJO字段时，属性类型对不上。或者自动映射出现问题

手动指定类型/检查映射字段是否符合java类型要求

11.9 There is no setter for property named '${name}' in class '${class}'

在 ${class} 类中找不到属性为${name} 的set方法使用resultMap 指定映射property值时对不上pojo的set方法和字段

写出set方法 或者将映射property的值设置为 pojo 拥有的set方法名
你知道吗? mybatis 会先去寻找名称为${name} 的set方法。找不到时会去寻找名称为${name}的字段如果还是找不到才会抛出这个异常。11.10同理

11.11 There is no getter for property named '${name}' in '${class}'

在 ${class} 类中找不到属性为${name} 的get方法

写出get 方法

11.11 java.lang.NoSuchMethodException: ${class01}.()

低版本的mybatis映射对象时对象必须拥有无参构造方法

创建无参构造即可
课外知识：这个异常也存在于反射中当getMethod("${methodName}"); 没有权限访问或者${methodName}不存在时会抛出此异常

11.12 java.lang.ClassCastException: ${class0} cannot be cast to ${class1}

不能将${class0} 转化成 ${class1} 十分经典的运行时异常，例如不能将String 转换为Integer 一样。一般出现在 CUD parameterType中

请检查你传入的参数类型是否与 parameterType所指定的类型一致。

11.13 Parameter {name} not found. Available parameters are [{collection}]

没有在{collection}中找到可用的形参{name}

请确定你的name存在于${collection} 中

11.14 Invalid argument value: java.io.NotSerializableException

不可序列化异常没有实现Serializable 接口????? implements Serializable

collection 指定为 list |map。 避免直接使用 list|map..

例:

 <insert id="insertUser">
        INSERT INTO `user`(`name`,`role_id`)
        values
        <foreach collection="list" separator=",">
            (#{list},#{list})
        </foreach>
    </insert>

 <insert id="insertUser">
        INSERT INTO `user`(`name`,`role_id`)
        values
        <foreach collection="map" separator=",">
            (#{map},#{map})
        </foreach>
    </insert>

避免发生上面的错误即可

11.15 java.lang.UnsupportedOperationException

不支持的操作异常操作Arrays 内部类 ArrayList也会抛出此异常。

mybatis 动态sql 中没有给list|map起别名使用list|map会抛出此异常（list|map是整个集合。）

请指定别名并用别名来操作属性

例:

 <insert id="insertUser">
        INSERT INTO `user`(`name`,`role_id`)
        values
        <foreach collection="list" separator="," >
            (#{list.name},#{list.role_id})
        </foreach>
    </insert>

 <insert id="insertUser">
        INSERT INTO `user`(`name`,`role_id`)
        values
        <foreach collection="map" separator="," >
            (#{map.name},#{map.role_id})
        </foreach>
    </insert>

WoW , 能在mybatis中遇到这个异常，都不是一般人。
为 foreach 指定 item 属性，并使用item起的别名来 .方法

注: 如果你的collection 指定的是 array ,传入的实参也是array 那么则会抛出 11.10 There is no getter..异常，其实也很好理解，因为数组是对象，而数组对象并不存在 #{array.name}这种奇特的set方法或字段

11.16 The expression '${value}' evaluated to a null value.

表达式 ${value} 计算结果为空值

foreach元素中的属性collection所指定的值不存在

11.17 Malformed OGNL expression: ...

表达式语法错误...

请检查你的表达式是否正确

例:

<if test="${name} != null and name != '' ">AND `name` LIKE concat('%',#{name},'%')</if>
<if test="name ! null and name != '' ">AND `name` LIKE concat('%',#{name},'%')</if>

11.18 Mapper method '...' has an unsupported return type:...

映射方法不支持返回类型

检查CRUD 与标签是否对应

例：

<insert id="selectAll">
    <include refid="sqlSelectAll"/>
</insert>

11.19 It's likely that neither a Result Type nor a Result Map was specified

可能没有指定结果类型或结果映射

在select 标签中加入属性 resultMap 或 resultType

11.20 Result Maps collection does not contain value for {resultMapName}

结果map 集中没有找到值 resultMapName

查看指定的resultMap 是否存在

11.21 Wrong namespace. Expected '{class}' but found '{namespace}'.

配置文件使用class映射mapper时，同包同class类名的xml文件的namespace与class类名不一致。

使用Class 映射mapper 时，同包同名的xml 的namespace 必须是同名class的全限定类名

11.22 No enum constant org.apache.ibatis.type.JdbcType.{type}

映射文件中所指定的 jdbcType 不存在于枚举常量

请查看jdbcType是否写正确

了解

mybatis 别名不区分大小写

Mybatis高版本支持自动有参构造方法创建对象。参数类型顺序需要和数据库中数据一一对应）

注意：Mybatis自动使用有参构造方法构建对象后也会执行pojo的set方法。就像Mybatis正常执行无参构造方法创建对象后会去寻找set方法为字段赋值时一样。
Mybatis自动使用有参构造方法是用来更灵活的创建对象的，并非是新增的一种映射对象的方式。
当然你不写set方法或者字段名跟数据库列对不上的时候，它默认也就按照有参构造形参的顺序来进行传参(这就可以实现你想象中的mybatis构造方法映射对象的方式)
注:如果传入实参不能被赋值给字段就会抛出 11.8 SQLDataException:Cannot determine value type from ... 异常