MyBatis-Plus 数据库字段排序不准确与常见开发坑点解析

MyBatis-Plus 字符串字段排序错误的原理与修复

在进行数据列表展示时，若发现排序结果不符合预期的数值大小顺序（例如：字符串 "12" 被排在 "8" 之前，因为字符比较按位判断，'1' < '8'），通常是因为排序字段使用了 VARCHAR 或文本类型，而数据库默认对字符串进行字典序而非数值排序。

第1步：纯 SQL 环境下的通用修复

在原生 MySQL 或 Oracle 环境中，强制将文本字段转换为数字类型即可解决此问题。以下两种写法均有效：

• ORDER BY column_name + 0
• ORDER BY column_name * 1

通过运算操作，数据库隐式将字符串转为数值型进行比较，从而还原正确的数字大小顺序。

第2步：MyBatis-Plus 代码实现修复

为了保持 MyBatis-Plus QueryWrapper 链式调用的简洁性，可以直接在排序方法中写入转换表达式。无需编写自定义 XML SQL，直接传递带算术运算符的字段名即可。

示例：使用 orderByDesc 进行倒序排列，在字段名后附加 +1：

// 按 visit_num 字段降序排列（避免字符串排序缺陷）
queryWrapper.orderByDesc("visit_num+1");

MyBatis-Plus 开发中的 9 大常见坑点与排查

1. 数据库枚举映射失效

当数据库字段为 TINYINT(1) 时，部分 JDBC 驱动或版本可能将其自动映射为布尔值（Boolean），导致 Java 实体类接收到的枚举值异常。

建议：检查数据库列定义，尽量使用 TINYINT(2) 或其他非单比特宽度的整数类型来存储枚举索引。

2. 自增主键未生效

如果数据库表设置了自增主键，但插入后 ID 仍由框架分配错误或重复，需确认实体类 ID 字段的注解配置。

必须添加：@TableId(type = IdType.AUTO)。若不需要复杂的主键策略且仅用自增，有时甚至需要明确标记 ID 字段或通过全局配置指定 ID 类型，否则可能会触发雪花算法等其他分布式ID生成策略。

3. MyBatis 嵌套/关联查询主键缺失

在进行子查询或多表关联时，务必确保返回的结果集中包含实体的唯一标识（主键）。否则框架无法正确封装对象状态，导致数据回写失败或部分属性为空。

4. UpdateTime 自动更新时间不生效

许多开发者会在数据库中设置 DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP，期望实体类修改后数据库自动刷新时间。但在 MyBatis-Plus 执行 UpdateWrapper 更新时，如果生成的 SQL 不包含该字段，数据库层的自动更新时间机制不会触发。

解决：手动在 Wrapper 中设置 set("updateTime", new Date())，或使用 mapper.updateById(entity)（前提是实体类配置了 @TableField(fill = FieldFill.UPDATE) 并结合 MetaObjectHandler 处理）。

5. LambdaQuery 空参数污染 SQL

使用 LambdaQueryWrapper 时，如果传入的参数变量为 null，默认的 eq() 条件会将 = null 拼接到 SQL 中（即 WHERE branch_code IS NULL），这往往不是业务想要的“忽略该条件”。若不想查询为空的数据，应使用 ne() 或在包装器构建前做空值过滤。

6. Integer 包装类型的 Null 判断

实体类中定义为 Integer 的非基本类型字段，默认为 null。在执行某些逻辑判断时，未意识到其初始空值可能导致 NullPointerException 或逻辑分支走偏。

7. 基础类型与字符串值的匹配

在处理类似客户标志 customerIssueFlag（值为 Y 或 N）的场景时，需注意数据库存储的实际字节大小和字符集。若查询语句拼接不当或ORM映射时对字符类型强转，可能会导致比对失败。

8. 事务传播行为失效

在 Service 层调用时，若没有正确声明事务注解（如 @Transactional）或其属性（如 rollbackFor）不正确，一旦涉及多步更新或跨库操作，可能出现中间成功最后回滚不完全的情况。需注意 Spring AOP 代理对方法内部自调用失效的问题。

9. 多数据源配置下的 Mapper 冲突

在项目配置多个数据源（如读库/写库）时，若除主数据源外的 Mapper 接口也标记了标准的 @Mapper 注解，可能会与 Spring Boot 默认的全包扫描产生冲突，导致 Bean 覆盖或找不到指定的 DataSource。

解决：自定义配置的从库 Mapper 建议取消 @Mapper，转而使用特定的 @MapperScan 路径隔离，或者依赖全局配置类的组件扫描机制。

以上就是MyBatis-Plus数据库字段排序不准确及常见开发问题的详细内容，更多关于MyBatis-Plus踩坑指南的资料请关注本站其它相关文章！