jOOQ 不支持原生 batchUpdate() + returning() 组合，但可通过 UPDATE ... FROM VALUES 语法（配合 returning()）在 PostgreSQL、SQL Server 等主流数据库中实现单条 SQL 批量更新并获取全部变更行，兼顾性能与可观测性。
jooq 不支持原生 `batchupdate()` + `returning()` 组合，但可通过 `update ... from values` 语法（配合 `returning()`）在 postgresql、sql server 等主流数据库中实现单条 sql 批量更新并获取全部变更行，兼顾性能与可观测性。
在使用 jOOQ 进行批量状态更新时，开发者常期望像单条 UPDATE ... RETURNING 那样一次性获取所有被修改记录的完整快照（如 WriteOffRequest 实体）。然而，jOOQ 当前（截至 3.18 版本）不支持对 batchUpdate() 调用链式 .returning() 方法——该调用在编译期即失败，因为 BatchBindStep.execute() 返回的是 int[] 更新计数，而非结果集。
根本原因在于：JDBC 规范本身未定义批量更新后返回结果集的标准行为，各数据库驱动支持程度差异极大。jOOQ 的 batchUpdate() 本质是底层 JDBC Statement.addBatch() / executeBatch() 的封装，其设计目标是吞吐优先，牺牲了单语句级的行级反馈能力。
✅ 正确解法：用 单条 UPDATE ... FROM (VALUES...) + RETURNING 替代循环或批处理
该方案将多条独立更新合并为一条 SQL，利用数据库原生能力完成“批量定位 + 批量赋值 + 批量返回”，具备原子性、高性能和强一致性：
fun updateStatuses(
writeOffRequestsIds: Collection<UUID>,
status: WriteOffRequestStatus
): List<WriteOffRequest> {
if (writeOffRequestsIds.isEmpty()) return emptyList()
// 构建 VALUES 派生表：(id, status) 行集合
val valuesTable = DSL.values(
writeOffRequestsIds.map { id ->
row(id, status)
}
).`as`("s", "id", "status")
return db
.update(WRITE_OFF_REQUEST)
.set(WRITE_OFF_REQUEST.STATUS, valuesTable.field("status", SQLDataType.VARCHAR))
.set(WRITE_OFF_REQUEST.UPDATED_AT, LocalDateTime.now())
.from(valuesTable)
.where(WRITE_OFF_REQUEST.ID.eq(valuesTable.field("id", SQLDataType.UUID)))
.returning() // ✅ 支持！返回 WRITE_OFF_REQUEST.* 全字段
.fetchInto(WriteOffRequest::class.java)
}? 关键说明：
-
DSL.values(...)是 jOOQ 对 SQLVALUES构造器的类型安全封装，生成内联数据集； -
FROM (VALUES...) AS s允许UPDATE直接关联临时数据源，避免 N+1 查询； -
.returning()在支持该特性的方言（PostgreSQL、SQL Server、Oracle 等）中可完整返回更新后的行； - 若目标数据库不支持（如 MySQL），需降级为「先
SELECT FOR UPDATE锁定 → 再UPDATE→ 最后SELECT查询」两阶段方案，或启用ROW_COUNT()辅助验证。
⚠️ 注意事项：
-
空集合防御：务必提前校验
writeOffRequestsIds.isEmpty()，否则VALUES ()语法非法； -
类型显式声明：
valuesTable.field("id", SQLDataType.UUID)显式指定字段类型，避免方言推导失败； -
事务边界：此操作应在显式事务内执行（
db.transaction { ... }），确保RETURNING结果与业务逻辑一致； -
性能对比：单条
UPDATE ... FROM VALUES的网络往返为 1 次，远优于 N 次单条UPDATE或batchUpdate()（后者仍无法返回行）。
? 总结：jOOQ 的批量更新本质是 JDBC 批处理的抽象，不提供结果集反馈；而 UPDATE ... FROM VALUES ... RETURNING 是数据库层的高级能力，jOOQ 通过方言适配将其暴露为简洁 API。生产环境中，应优先采用后者——它既满足“返回所有更新行”的业务诉求，又规避了手动拼接 SQL 或开启危险 JDBC 参数（如 allowMultiQueries）的风险。
