Mybatis-plus空值插入失败解决方法

Mybatis-plus空值插入问题解析

在使用MyBatis-Plus进行数据持久化操作时，开发者常会遇到一个典型问题：当实体类字段值为null时，执行插入操作可能触发异常，导致数据无法正常写入数据库。这种情况通常源于框架在类型映射时对空值处理的默认机制。

常见异常现象

系统通常会抛出如下类型的错误信息：

org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.type.TypeException: Could not set parameters for mapping: ParameterMapping{property='couldDismantle', mode=IN, ja vaType=class ja va.lang.Long, jdbcType=null, numericScale=null, resultMapId='null', jdbcTypeName='null', expression='null'}. Cause: org.apache.ibatis.type.TypeException: JDBC requires that the JdbcType must be specified for all nullable parameters.

异常核心表明：当字段值为null时，MyBatis无法自动推断对应的JDBC类型（JdbcType），导致参数绑定失败。这并非业务逻辑错误，而是框架在处理空值映射时需要显式类型指示。

解决方案一：YAML全局配置

在Spring Boot项目中，可通过修改application.yml配置文件统一处理空值类型：

mybatis:
  configuration:
    mapUnderscoreToCamelCase: true
    jdbc-type-for-null: 'null'
  mapper-locations: classpath*:mapper/*.xml

关键配置项jdbc-type-for-null: 'null'将空值统一映射为JdbcType.NULL，使框架在遇到null参数时能正确生成SQL语句。

解决方案二：Java配置类设置

对于多数据源或需要精细化配置的场景，可通过Java配置类实现：

@Configuration
@MapperScan(basePackages = {"com.XXXX.mapper"}, sqlSessionFactoryRef = "XXXXXX")
public class DbYYConfig {

    @Autowired
    @Qualifier("XXXX")
    private DataSource dataSourceDb2;

    @Bean
    public SqlSessionFactory sqlSessionFactoryDb2() throws Exception {
        SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
        factoryBean.setDataSource(dataSourceDb2);
        factoryBean.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/*.xml"));
        
        org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration();
        configuration.setMapUnderscoreToCamelCase(true);
        configuration.setJdbcTypeForNull(JdbcType.NULL);
        factoryBean.setConfiguration(configuration);
        
        return factoryBean.getObject();
    }

    @Bean
    public SqlSessionTemplate sqlSessionTemplateDb2() throws Exception {
        return new SqlSessionTemplate(sqlSessionFactoryDb2());
    }

}

通过configuration.setJdbcTypeForNull(JdbcType.NULL)显式设置空值处理策略，效果与YAML配置完全一致。

总结

MyBatis-Plus空值插入异常的本质是未明确指定null参数的JDBC类型。通过全局配置或Java代码配置均可解决该问题。YAML配置适合快速统一处理，Java配置类则适用于复杂数据源场景。根据项目架构选择合适方案即可有效规避此问题。