MyBatis-Plus批量插入性能优化：字段NULL值处理策略

问题背景

在使用MyBatis-Plus进行批量数据插入操作时，开发者可能会遇到一个性能问题：当批量数据中存在某些字段间歇性为NULL值时，会导致MyBatis-Plus生成不同的SQL预处理语句，从而显著降低批量插入的性能。

现象分析

通过实际案例观察，可以总结出以下几种典型场景：

1. 间歇性NULL值场景：当批量数据中某个字段（如hospital字段）间隔出现NULL值时，MyBatis-Plus会为每条记录生成不同的预处理语句，导致频繁的SQL语句重新编译，插入4000条数据耗时超过20秒。

2. 全量有值场景：当所有记录的字段都有值时（即使部分字段值为NULL），MyBatis-Plus会使用统一的预处理语句，插入1万条数据仅需1秒左右。

3. 混合场景：当数据中存在无规律的NULL值时，性能表现不稳定，有时正常有时显著下降。

根本原因

MyBatis-Plus默认采用了一种优化策略：在生成INSERT语句时，会自动忽略NULL值字段。这种设计本意是为了减少不必要的数据传输和存储，但在批量处理场景下却带来了副作用：

1. 当批量数据中字段NULL值出现无规律时，会导致MyBatis-Plus为不同结构的记录生成不同的预处理语句。

2. 数据库需要频繁编译新的SQL语句，无法充分利用预处理语句的缓存优势。

3. JDBC驱动每次执行不同结构的SQL时都需要重新准备，增加了额外的开销。

解决方案

方案一：全局配置字段插入策略

在MyBatis-Plus配置中，可以设置全局的字段插入策略，强制包含所有字段（包括NULL值）：

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加其他拦截器...
        
        // 设置全局字段策略
        GlobalConfig globalConfig = new GlobalConfig();
        GlobalConfig.DbConfig dbConfig = new GlobalConfig.DbConfig();
        dbConfig.setInsertStrategy(FieldStrategy.ALWAYS); // 强制包含所有字段
        globalConfig.setDbConfig(dbConfig);
        
        return interceptor;
    }
}

方案二：实体类字段注解配置

对于特定实体类，可以使用@TableField注解指定字段策略：

public class CenterDoctor {
    @TableField(insertStrategy = FieldStrategy.ALWAYS)
    private String hospital;
    
    // 其他字段...
}

方案三：自定义批量插入方法

对于性能要求极高的场景，可以考虑实现自定义的批量插入方法：

1. 使用MyBatis的批量执行器
2. 编写包含所有字段的固定SQL模板
3. 使用JDBC的批量操作API

性能对比

场景	记录数	处理时间	性能差异原因
间歇NULL	4000	20+秒	频繁SQL重新编译
全量有值	10000	~1秒	统一预处理语句
配置优化后	4000	<1秒	固定SQL模板

最佳实践建议

1. 对于批量插入操作，推荐统一设置FieldStrategy.ALWAYS策略
2. 在数据预处理阶段，可以考虑将NULL值转换为有意义的默认值
3. 对于大型批量操作，合理设置批处理大小（batchSize）
4. 考虑使用MyBatis-Plus的saveBatch方法时指定适当的批处理大小

总结

MyBatis-Plus的字段策略设计在单条记录操作时能带来便利，但在批量处理场景下可能导致性能问题。通过合理配置字段插入策略，可以显著提升批量数据操作的性能。开发者应当根据实际业务场景，在数据完整性和操作性能之间找到平衡点。