开发避坑指南(20) ：MyBatis操作Oracle插入NULL值异常“无效列类型1111“解决方案

原创已于 2025-08-20 22:26:21 修改 · 565 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #oracle

于 2025-08-07 18:35:12 首次发布

避坑指南专栏收录该内容

71 篇文章

订阅专栏

错误信息

[ERROR] - org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.type.TypeException: 
Could not set parameters for mapping: ParameterMapping{property='orderNo', mode=IN, javaType=class java.lang.String, jdbcType=null, 
numericScale=null, resultMapId='null', jdbcTypeName='null', expression='null'}. Cause: org.apache.ibatis.type.TypeException: 
Error setting null for parameter #4 with JdbcType OTHER . Try setting a different JdbcType for this parameter or a different jdbcTypeForNull 
configuration property. Cause: java.sql.SQLException: 无效的列类型: 1111

错误背景

使用mybatis的insert()方法插入Null值到oracle数据库时报错。

错误分析

从错误信息看，受影响的参数是第4个，相关报错的字段是orderNo，该字段的类型是字符串类型java.lang.String，而当前配置的类型是jdbcType=null。与MySQL不同，Oracle对NULL值的类型校验更严格，当MyBatis向Oracle插入NULL值时，默认会尝试使用JdbcType.OTHER类型，而Oracle驱动无法识别该类型，导致报错"无效的列类型: 1111"。

解决办法

将insert()方法修改为insertSelective()，仅插入非NULL字段值，自动忽略NULL值字段，避免数据库默认值被覆盖。

其他方案

（1）如果是xml中自定的插入语句，需要在XML映射文件指定jdbcType，比如：

<!-- 在参数占位符中显式声明jdbcType -->
<insert id="insertData">
  INSERT INTO table_name (column1, column2) VALUES (#{param1,jdbcType=VARCHAR}, #{param2,jdbcType=NUMERIC})
</insert>

（2）全局配置jdbcTypeForNull，如

<!-- mybatis-config.xml中配置 -->
<settings>
  <setting name="jdbcTypeForNull" value="NULL"/>
</settings>

（3）MyBatis-Plus配置，如

# application.yml配置
mybatis-plus:
  configuration:
    jdbc-type-for-null: 'null'