MyBatis全表更新风险防范指南

一、全表更新风险概述

在使用MyBatis进行数据库操作时，由于业务数据校验不当，可能会造成全表更新或删除的风险。这种风险通常出现在以下场景：

1. 参数为空导致WHERE条件缺失：当DAO层未做非空校验，关键字段传入为空时，可能导致WHERE条件缺失
2. 逻辑删除字段滥用：使用统一逻辑删除字段(如yn=0)作为条件，可能意外删除全表数据
3. 危险条件构造：如1=1、1<>2等恒真条件可能导致全表操作

典型风险示例：

update cms_relation_area_code set yn = 1 where yn = 0  -- 全表逻辑删除

二、MyBatis核心原理与扩展点

1. MyBatis执行流程

1. 加载配置文件：读取mybatis-config.xml
2. 创建SqlSessionFactory：实际创建DefaultSqlSessionFactory对象
3. 创建SqlSession：实际创建DefaultSqlSession对象
4. 获取Mapper代理：使用JDK动态代理技术创建Mapper接口实现
5. 执行SQL操作：通过Executor执行具体SQL

2. MyBatis四大扩展点

MyBatis提供了四个核心拦截器扩展点，可用于实现插件：

1. Executor：SQL执行器，负责SQL动态解析、生成BoundSql对象
2. StatementHandler：SQL语法构建器，负责JDBC Statement操作
3. ParameterHandler：参数处理器，负责SQL参数处理
4. ResultSetHandler：结果集处理器，负责结果集封装

三、全表更新防护插件实现

1. 插件设计思路

基于StatementHandler拦截器实现防护SDK，主要流程：

1. 获取预处理SQL及参数值
2. 替换占位符组装完整SQL
3. SQL语句规则解析
4. 校验是否为全表更新SQL

2. 可拦截的SQL类型

插件能够识别并拦截以下危险SQL模式：

• 无WHERE条件：update/delete table
• 逻辑删除字段：update/delete table where yn = 0
• 拼接条件语句：update/delete table where 1 = 1
• AND条件语句：update/delete table where 1 = 1 and 1 <> 2
• OR条件语句：update/delete table where 1 = 1 or 1 <> 2

3. 插件配置选项

插件提供灵活的配置选项：

1. 默认逻辑删除字段：如yn
2. 白名单表：指定不拦截的表
3. 表级逻辑删除字段映射：为特定表指定不同的逻辑删除字段

四、插件接入指南

1. 依赖配置

确保项目包含以下依赖（版本根据实际情况调整）：

<!-- 必需依赖 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>${mybatis.version}</version>
    <scope>provided</scope>
</dependency>

<!-- 插件核心依赖 -->
<dependency>
    <groupId>com.jd.o2o</groupId>
    <artifactId>o2o-mybatis-interceptor</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>

<!-- 辅助依赖 -->
<dependency>
    <groupId>p6spy</groupId>
    <artifactId>p6spy</artifactId>
    <version>${p6spy.version}</version>
</dependency>
<dependency>
    <groupId>com.github.jsqlparser</groupId>
    <artifactId>jsqlparser</artifactId>
    <version>${jsqlparser.version}</version>
</dependency>

2. Spring Boot项目配置

@Configuration
public class MybatisConfig {
    @Bean
    ConfigurationCustomizer configurationCustomizer() {
        return configuration -> {
            FullTableDataOperateInterceptor interceptor = new FullTableDataOperateInterceptor();
            // 默认逻辑删除字段
            interceptor.setLogicField("yn");
            // 白名单表配置
            interceptor.setWhiteTables(Arrays.asList("table1", "table2"));
            // 表级逻辑删除字段映射
            Map<String,String> fieldMap = new HashMap<>();
            fieldMap.put("table3", "ynn");
            interceptor.setTableToLogicFieldMap(fieldMap);
            
            configuration.addInterceptor(interceptor);
        };
    }
}

3. 传统SSM项目配置

在mybatis.xml中添加：

<configuration>
    <plugins>
        <plugin interceptor="com.jd.o2o.cms.mybatis.interceptor.FullTableDataOperateInterceptor">
            <property name="logicField" value="yn"/>
            <property name="whiteTables" value="table1,table2"/>
            <property name="tableToLogicFieldMap" value="table3:ynn"/>
        </plugin>
    </plugins>
</configuration>

4. 日志配置

建议添加以下日志配置以监控拦截情况：

<Logger name="com.jd.o2o.cms.mybatis.interceptor" level="error" additivity="false">
    <AppenderRef ref="RollingFileError"/>
</Logger>

五、性能与安全考量

1. 性能影响

插件对各类操作的影响：

• SELECT：无性能影响
• INSERT：< 0.001ms
• UPDATE：约0.02ms
• DELETE：约0.02ms

2. 安全机制

• 异常处理：解析过程中的异常会被捕获，不影响正常业务流程
• 白名单机制：关键业务表可配置为白名单
• 日志监控：所有拦截操作都会记录错误日志

六、最佳实践建议

1. 结合业务校验：不应完全依赖插件，DAO层应做必要参数校验
2. 合理使用事务：高风险操作应在事务中执行，便于回滚
3. 定期审计SQL：结合插件日志定期审计系统SQL操作
4. 权限最小化：数据库账号应遵循最小权限原则
5. 备份策略：重要数据应有定期备份机制

通过合理配置和使用此插件，可以显著降低MyBatis使用过程中的全表操作风险，同时保持系统的高性能和稳定性。