mybatisplus逻辑删除失效

### MyBatis-Plus 逻辑删除失效的原因及解决方案 #### 可能原因分析 1. **全局配置错误** 如果 `application.yml` 中的全局配置项设置不正确，可能导致逻辑删除功能无法正常工作。例如，如果未正确定义 `logic-delete-field` 或其对应的值（如 `logic-not-delete-value` 和 `logic-delete-value`），则框架可能不会识别该字段作为逻辑删除标志[^1]。 2. **实体类缺少注解** 即使全局配置已启用逻辑删除支持，但如果实体类中的逻辑删除字段未标注 `@TableLogic` 注解，则 MyBatis-Plus 不会将其视为逻辑删除字段[^3]。 3. **SQL 执行过程中被覆盖** 在某些情况下，开发者可能会手动编写 SQL 并绕过 MyBatis-Plus 的自动处理机制。这种做法容易导致逻辑删除字段未被更新或忽略。通过源码分析可以发现，只有当 `logicDelete` 参数为 `true` 时，才会触发逻辑删除行为[^2]。 4. **版本兼容性问题** 使用较旧版本的 MyBatis-Plus 时可能存在 Bug 导致逻辑删除功能异常。建议升级到最新稳定版以修复潜在问题[^3]。 5. **数据库字段类型不符** 数据库表中用于存储逻辑删除状态的字段应与 Java 实体类属性的数据类型一致。如果不匹配，也可能引发逻辑删除失败的情况。 --- #### 解决方案 ##### 配置检查 确保项目中的 `application.yml` 文件包含如下正确的全局配置： ```yaml mybatis-plus: global-config: db-config: logic-delete-field: deleted # 逻辑删除字段名 logic-not-delete-value: 0 # 逻辑未删除值 logic-delete-value: 1 # 逻辑删除值 ``` ##### 实体类调整 确认实体类中代表逻辑删除状态的字段添加了 `@TableLogic` 注解。例如： ```java import com.baomidou.mybatisplus.annotation.TableLogic; public class User { private Long id; @TableLogic private Integer deleted; // 对应数据库中的逻辑删除字段 } ``` ##### 自定义 Mapper 方法验证 若自定义了 `BaseMapper` 接口的方法而遇到逻辑删除失效现象，需仔细排查实现细节是否遵循官方推荐的最佳实践。必要时可通过调试工具跟踪调用链路并定位具体环节是否存在偏差[^2]。 ##### 版本管理优化 当前使用的依赖版本较低，存在一定的风险隐患。可考虑将相关组件升级至更高版本来获得更完善的特性支持以及性能改进。以下是示例 POM 文件片段供参考： ```xml <dependencies> <!-- MyBatis Plus Core --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3</version> <!-- 替换为最新的稳定版本号 --> </dependency> <!-- Code Generator (Optional) --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-generator</artifactId> <version>3.5.3</version> </dependency> </dependencies> ``` ##### 测试案例构建 为了进一步验证修正措施的有效性，可以通过单元测试的方式模拟不同场景下的增删改查操作流程。下面给出一段简单的代码样例展示如何针对单条记录执行逻辑删除动作： ```java @Test void testLogicDelete() { LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(User::getId, 1L); boolean result = userMapper.delete(queryWrapper); Assertions.assertTrue(result); // 断言删除成功 } // 查询已被标记为“已删除”的数据 @Test void testSelectDeletedRecords() { List<User> users = userMapper.selectList(new QueryWrapper<User>().eq("deleted", 1)); System.out.println(users.size()); } ``` --- ###