mybatis 需要注意的点 MyBatis 插入空值时,需要指定JdbcType

本文详细解析了在使用MyBatis框架与Oracle数据库交互时,因未指定JdbcType而导致的空值异常问题。通过修改SQL映射文件中的参数类型,或在mybatis-config.xml中全局设置jdbcTypeForNull,有效避免了错误的发生。

前天遇到一个问题 异常显示如下: 

Exception in thread "main" org.springframework.jdbc.UncategorizedSQLException: Error setting null for parameter #6 with JdbcType OTHER . Try setting a different JdbcType for this parameter or a different jdbcTypeForNull configuration property. Cause: java.sql.SQLException: 无效的列类型: 1111 
; uncategorized SQLException for SQL []; SQL state [99999]; error code [17004]; 无效的列类型: 1111; nested exception is java.sql.SQLException: 无效的列类型: 1111

对应的sqlmap如下: 

<insert id="insertCustomerLog" parameterType="map">  
      insert into customer_log  
      (  
      ID,  
      CUSTOMER_SERVICE_USER_NAME,  
      user_name,  
      CONTENT,  
      LOG_FIRST_TYPE,  
      STATUS,  
      LINKED_ID,  
      FEE,  
      ACCOUNT_FIRST_TYPE,  
      ACCOUNT_SECOND_TYPE,  
      ACCOUNT_THIRD_TYPE,  
      LOG_SECOND_TYPE,  
      LOG_IP,  
      MEMO  
      )  
      values  
      (  
             seq_customer_log.nextval ,  
            #{customerServiceUserName} ,  
            #{username},  
            #{content},  
            #{logFirstType},  
            #{status},  
            #{linkedId},  
            #{fee},  
            #{accountFirstType},  
            #{accountSecondType},  
            #{accountThirdType},  
            #{logSecondType},  
            #{logIp},  
            #{memo}  
      )  
  </insert>  

查询了一下 一些资料说是: 

MyBatis 插入空值时,需要指定JdbcType ,mybatis insert空值报空值异常,但是在pl/sql不会提示错误,主要原因是mybatis无法进行转换。

<insert id="insertCustomerLog1" parameterType="com.diyicai.customer.domain.CustomerLog">  
        insert into customer_log  
               (  
               ID,  
               CUSTOMER_SERVICE_USER_NAME,  
               user_name ,  
               CONTENT,  
               LOG_FIRST_TYPE,  
               STATUS,  
               LINKED_ID,  
               FEE,  
               ACCOUNT_FIRST_TYPE,  
               ACCOUNT_SECOND_TYPE,  
               ACCOUNT_THIRD_TYPE,  
               LOG_SECOND_TYPE,  
               LOG_IP,  
               MEMO  
               )  
               values  
               (  
               seq_customer_log.nextval ,  
               #{customerServiceUserName,jdbcType=VARCHAR} ,  
               #{username,jdbcType=VARCHAR},  
               #{content,jdbcType=VARCHAR},  
               #{logFirstType,jdbcType=NUMERIC},  
               #{status,jdbcType=NUMERIC},  
               #{linkedId,jdbcType=VARCHAR},  
               #{fee,jdbcType=NUMERIC},  
               #{accountFirstType,jdbcType=NUMERIC},  
               #{accountSecondType,jdbcType=NUMERIC},  
               #{accountThirdType,jdbcType=NUMERIC},  
               #{logSecondType,jdbcType=NUMERIC},  
               #{logIp,jdbcType=VARCHAR},  
               #{memo,jdbcType=VARCHAR}  
               )  
    </insert>  

错误日志是在:org.apache.ibatis.type.BaseTypeHandler这个类的第17行打出的。根据异常上面的代码 :

if (parameter == null) {  
  if (jdbcType == null) {  
  try {  
  ps.setNull(i, JdbcType.OTHER.TYPE_CODE);  
  } catch (SQLException e) {  
  throw new TypeException("Error setting null parameter. Most JDBC drivers require that the JdbcType must be specified for all nullable parameters. Cause: " + e, e);  
  }  
  } else {  
  ps.setNull(i, jdbcType.TYPE_CODE);  
  }  
  } else {  
  setNonNullParameter(ps, i, parameter, jdbcType);  
  }  

可以看出,是因为你传入的参数的字段为null对象无法获取对应的jdbcType类型,而报的错误。 你只要在insert语句中insert的对象加上jdbcType就可以了,修改如下: #{menuTitle,jdbcType=VARCHAR} ,这样就可以解决以上错误了。 

但是,如果我们为每个sql都指定jdbc类型,也比较麻烦,可以mybatis-config.xml种全局设置下:

	<settings>
		<setting name="jdbcTypeForNull" value="NULL"/>
	</settings>

另外,再补充一点资料,可能更能让我们了解问题的真相:

适配oracle数据库的时候,mybatis报了Error setting null parameter,bug发现是参数出现了null值,对于Mybatis,如果进行操作的时候,没有指定jdbcType类型的参数,就可能导致问题。

postgreSQL,MySQL,SQLSERVER都支持JdbcType.NULL类型,Oracle是不支持,适配的时候也因为这个问题导致mybatis报错。

比如,之前配置#{submitDate},它会在oracle中报错:Error settingnull parameter

更改成#{submitDate,jdbcType=DATE},注意jdbcType是区分大小写的。

 

 

<think>好的,用户的问题是关于在使用MyBatis对Oracle数据库进行批量插入,如何处理空值的问题。首先,我需要回忆一下MyBatis处理空值的一般方法,特别是针对Oracle数据库的情况。根据之前的引用资料,用户在批量插入遇到空值问题,比如ORA-01790错误,这通常是因为数据类型不匹配导致的。 首先,用户可能已经知道单个插入,在MyBatis的映射文件中指定jdbcType可以解决空值问题,比如使用#{field,jdbcType=DATE}。但批量插入,情况可能更复杂,因为批量操作的结构可能与单条插入不同。根据引用3中的例子,用户使用了UNION ALL的方式批量插入,并且在字段中指定jdbcType,特别是在日期字段上。这可能是因为Oracle在类型推断,如果没有明确指定类型,当值为null无法确定类型,导致错误。 接下来,我需要考虑不同的批量插入方法,比如使用INSERT ALL、UNION ALL,或者foreach循环。不同的方法可能在处理空值需要不同的处理方式。例如,INSERT ALL方式可能需要每个记录都包含类型提示,而UNION ALL方式可能需要每个SELECT子句中的字段都明确类型。 此外,全局配置也是一个可能的方法,比如在MyBatis的配置文件中设置jdbcTypeForNull,这样所有未指定类型的参数都会使用默认的jdbcType。但根据引用4中的例子,用户可能在注解中直接指定jdbcType,或者在XML映射文件中为每个可能为null的字段指定类型。 还需要注意Oracle的JDBC驱动对空值的处理,特别是在批量操作中,可能对类型更加敏感。例如,日期类型的字段如果没有值,必须明确指定为DATE类型,否则驱动可能无法正确处理,导致类型不匹配的错误。 用户的问题可能集中在如何调整他们的批量插入SQL语句,以及在字段映射中添加必要的jdbcType属性。此外,可能还需要检查是否有其他字段可能为空,并确保每个可能为null的字段都指定了正确的jdbcType。 最后,要总结几种常见的处理方法,包括字段级类型指定、全局配置、以及使用特定批量插入语法注意事项。可能还需要提到测试和验证的方法,比如逐步添加类型提示,查看错误是否消失,或者分批插入数据以定位问题记录。</think>以下是MyBatis操作Oracle数据库批量插入处理空值的解决方案,综合引用资料和实际开发经验整理: ### 一、问题根源 Oracle数据库在批量插入,若字段存在空值且未明确指定数据类型,JDBC驱动无法自动推断类型,导致$ORA-01790$错误[^3][^4]。 ### 二、解决方案 #### 1. 字段级类型声明(推荐) 在所有可能为空的参数中强制指定`jdbcType` ```xml <insert id="insertList"> INSERT INTO table_name ( date_field, varchar_field ) <foreach collection="list" item="item" separator=" union all "> SELECT #{item.dateField,jdbcType=DATE}, #{item.varcharField,jdbcType=VARCHAR} FROM dual </foreach> </insert> ``` *必须为所有可能为null的字段添加类型声明*[^3] #### 2. 全局配置兜底 在`mybatis-config.xml`中设置: ```xml <settings> <setting name="jdbcTypeForNull" value="NULL"/> </settings> ``` 该配置会为所有未明确声明jdbcTypenull参数自动添加`OTHER`类型,但Oracle对`OTHER`类型的支持有限,建议与字段级声明配合使用[^4] #### 3. 批量插入语法适配 ##### 方案A:UNION ALL方式(适合小批量) ```xml <foreach collection="list" item="item" separator=" union all "> SELECT #{item.field1,jdbcType=TIMESTAMP}, #{item.field2,jdbcType=NUMERIC} FROM dual </foreach> ``` *每个字段必须显式声明类型*[^3] ##### 方案B:INSERT ALL方式(适合大批量) ```xml <foreach collection="list" item="item"> INTO table_name VALUES( #{item.field,jdbcType=VARCHAR}, #{item.dateField,jdbcType=DATE} ) </foreach> SELECT 1 FROM dual ``` *需注意Oracle单次插入最多支持1000条记录*[^2] ### 三、验证方法 1. 使用`mybatis-logger`输出最终执行的SQL 2. 在PL/SQL Developer中直接执行生成的SQL进行验证 3. 分批插入定位问题数据(如:100条/批) ### 四、特殊类型处理 | 字段类型 | jdbcType声明 | 注意事项 | |---------------|--------------|-------------------------| | DATE | DATE | 必须精确到年月日 | | TIMESTAMP | TIMESTAMP | 含分秒的日期类型 | | CLOB | CLOB | 需用`@TypeHandler`注解 | | BLOB | BLOB | 禁止直接传null |
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值