MyBatis调用Oracle存储过程取自定义对象类型时TypeHandler未生效报ORA-29478
问题根因
- 核心配置错误:你的
resultMap中client字段的javaType配置错误,全类名填成了org.ssc.gss.entity.TestEntity,但实际client属性对应的Java类型是org.ssc.gss.entity.BaseEntity。MyBatis加载自定义TypeHandler时,会优先校验配置的javaType是否和属性实际类型匹配,匹配失败时会直接跳过你指定的Handler,改用JDBC驱动的默认逻辑处理列值——这就是你的TypeHandler完全没被触发的直接原因。 - ORA-29478触发逻辑:Oracle JDBC驱动默认不支持直接读取游标中的用户自定义对象(OBJECT类型)列,当MyBatis跳过自定义Handler时,驱动直接收到原始STRUCT类型的列读取请求,因没有显式的对象拆解逻辑,直接抛出ORA-29478错误。
- 列名匹配偏差:Oracle返回结果集时,对函数、表达式生成的列会自动将列名转为大写,你当前配置的
column="client"是小写,即便修正javaType,列名和实际返回的大写列名CLIENT不匹配,依然会导致映射失效。 - 插入场景能正常用Handler的原因:插入参数绑定时,MyBatis会直接识别你传入参数的真实类型(BaseEntity实例),配合你显式指定的TypeHandler配置完成绑定,不存在XML配置的javaType校验偏差,因此功能正常。
解决步骤
- 第一步修正resultMap配置,对齐实际的类型和列名,同时避免原配置中resultMap id和映射类型类名同名的冲突问题,正确的配置示例:
<resultMap id="TestEntityMap" type="org.ssc.gss.entity.TestEntity"> <!-- 对齐Oracle返回的大写列名,补全普通字段映射 --> <result property="name" column="NAME"/> <result property="description" column="DESCRIPTION"/> <!-- 修正client字段配置:javaType替换为实际的BaseEntity全类名,列名对齐实际返回的CLIENT --> <result property="client" column="CLIENT" javaType="org.ssc.gss.entity.BaseEntity" typeHandler="org.ssc.gss.utils.OracleBaseEntityHandler" /> </resultMap>
- 第二步确认自定义TypeHandler的实现覆盖结果集读取场景:你之前用于插入的Handler只实现了
setNonNullParameter参数绑定逻辑,需要额外确认已正确实现结果集读取的重写方法,核心逻辑要包含:- 从结果集获取列对应的
oracle.sql.STRUCT实例 - 从STRUCT中依次提取id、name、description三个属性值,组装为BaseEntity实例返回
- 从结果集获取列对应的
- 第三步保持存储过程调用的SQL配置不变:当前配置的
statementType="CALLABLE"是正确的,因为你是通过存储过程的隐式游标(DBMS_SQL.RETURN_RESULT)返回结果集,MyBatis 3.5+版本默认可以识别该方式返回的结果集,不需要额外调整SQL逻辑。 - 验证排查:修正配置后,可以在TypeHandler的
getResult方法入口打断点,确认是否进入方法执行;如果仍未触发,检查是否存在全局注册的TypeHandler覆盖了局部配置,确认typeHandler的全类名没有拼写错误。
内容的提问来源于stack exchange,提问作者Ginger_Chacha
相关产品推荐
相关产品推荐

