当前位置：首页 > news >正文

mybatis plus 更新的时候返回更新记录的条数

news 2026/5/28 11:11:34

在 MyBatis-Plus 中，能否获取更新条数取决于你调用的是Mapper层还是Service层。官方设计有明确区分：

✅ 正确做法：调用`BaseMapper`（返回`int`）

BaseMapper的更新方法直接返回受影响的行数，与原生 MyBatis 一致。

// 1. 注入 Mapper @Autowired private DocumentMetadataMapper mapper; // 继承 BaseMapper<DocumentMetadata> // 2. 调用更新 int affectedRows = mapper.updateById(entity); // 或条件更新 int affectedRows = mapper.update(null, new LambdaUpdateWrapper<DocumentMetadata>() .set(DocumentMetadata::getKmStatus, 1) .eq(DocumentMetadata::getId, 100L)); if (affectedRows > 0) { log.info("成功更新 {} 条记录", affectedRows); }

⚠️ 易混淆点：`IService`返回`boolean`

如果你调用的是Service层（继承IService），默认返回boolean，不返回具体行数：

@Autowired private DocumentMetadataService service; // ❌ 返回 true/false，无法获取具体条数 boolean success = service.updateById(entity); // 底层实现：return baseMapper.updateById(entity) > 0;

📌结论：需要精确行数时，必须绕过 Service，直接调用Mapper。

🔑 核心配置：MySQL 必须加`useAffectedRows=true`

无论原生 MyBatis 还是 MP，MySQL 驱动默认返回的是匹配行数（Matched Rows），而非实际修改行数。若新旧值相同，会返回1导致误判。

JDBC URL 必须添加：

jdbc:mysql://127.0.0.1:3306/your_db?useAffectedRows=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai

配置状态	更新`status=1`→`status=1`	更新`status=1`→`status=2`	业务影响
无`useAffectedRows`	返回`1`	返回`1`	无法区分“数据未变”和“更新成功”
有`useAffectedRows=true`	返回`0`	返回`1`	✅ 精准反映实际变更

🛠 常见场景 & 避坑指南

场景	现象	解决方案
乐观锁更新	返回`0`	说明`@Version`版本冲突，需重试或抛异常
逻辑删除干扰	`updateById`不生效	检查是否被`@TableLogic`拦截，改用`mapper.update(null, wrapper)`绕过
批量更新要行数	`updateBatchById()`返回`boolean`	循环调用`mapper.updateById()`累加`int`，或写自定义`<update>`XML
PostgreSQL/Oracle	返回值行为不同	PG 默认返回`affected rows`；Oracle 需注意`SQL%ROWCOUNT`，通常无需额外参数

💡 最佳实践模板

public int updateKmStatusWithAudit(Long id, Integer newStatus) { int rows = mapper.update(null, new LambdaUpdateWrapper<DocumentMetadata>() .set(DocumentMetadata::getKmStatus, newStatus) .eq(DocumentMetadata::getId, id)); if (rows == 0) { throw new BusinessException("记录不存在或数据未发生变更"); } return rows; }