Java 后端 / 系统课时
理解 timeout 与 readOnly
理解 timeout 与 readOnly
本课解决两个常被误用的事务属性:timeout 控制事务允许持续多久,readOnly 表示当前事务以只读意图参与执行。重点不是背参数,而是看清 Spring、事务管理器与数据库之间各自真正负责什么。
学习目标
- 能解释
timeout到期后谁发现超时、事务如何结束,以及为什么它不等于数据库锁等待的统一上限。 - 能正确使用
readOnly,区分 Spring 层提示、JDBC 行为和数据库执行限制。 - 能根据业务边界判断这两个属性该放在哪里,避免把它们当成性能或数据安全的万能开关。
timeout 到底限制什么
@Transactional(timeout = 5) 的核心含义是:该事务不能超过约 5 秒的事务超时时间。事务管理器会记录截止时间,后续参与同一事务的资源操作可以据此拒绝继续执行或触发超时。
它首先是 Spring 事务语义,而不是“任何数据库操作都必须恰好在 5 秒时被数据库杀掉”。实际效果取决于事务管理器、底层资源以及当前操作是否能应用事务超时。
例如,下面这个服务把一次订单读取和计算放进同一事务。timeout 应该贴着真实事务边界配置,而不是随便加在每个 DAO 方法上。
package com.example.demo.order;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class OrderQueryService {
private final OrderRepository repository;
public OrderQueryService(OrderRepository repository) {
this.repository = repository;
}
@Transactional(timeout = 5, readOnly = true)
public OrderView queryOrder(long orderId) {
Order order = repository.findById(orderId)
.orElseThrow();
// 模拟业务计算;真实代码应避免把外部网络调用放进事务。
return OrderView.from(order);
}
public record OrderView(long id, String status) {
static OrderView from(Order order) {
return new OrderView(order.id(), order.status());
}
}
public interface OrderRepository {
java.util.Optional<Order> findById(long id);
}
public record Order(long id, String status) {
}
}预期结果
事务开始后,Spring 为该事务建立约 5 秒的超时边界。
方法正常完成时提交;超过事务截止时间后,后续事务操作可能失败,最终事务按事务管理器规则回滚。
readOnly 不会让返回的 Order 自动变成不可修改对象。readOnly 的真实边界
readOnly = true 表达的是“这个事务不会进行业务写入”的意图。Spring 可以把这一意图传递给底层事务资源,例如 JDBC 事务连接可以设置只读属性;某些 ORM 场景还会据此调整刷新策略。
但它不是通用的数据库写入权限控制。是否真正阻止 INSERT、UPDATE、DELETE,取决于数据库、驱动、事务管理器和 ORM 的具体行为。不能用它替代数据库账号权限、应用层校验或审计约束。
因此,下面两件事要分开理解:
| 属性 | 主要作用 | 不能保证 |
|---|---|---|
timeout |
约束 Spring 事务生命周期 | 所有数据库等待都在同一秒数内被取消 |
readOnly |
向事务资源表达只读意图 | 任何数据库环境都绝对禁止写入 |
对查询服务,readOnly = true 很合适;对“偶尔写一行”的方法,不要因为希望读取更快就随手打开只读事务。事务内部一旦需要写入,应让事务语义与实际工作一致。
常见误区与验证方式
第一个误区是认为 timeout = 5 等于数据库层 statement_timeout = 5s。两者可能联动,但并不是同一个配置项。排查超时问题时,应同时查看 Spring 日志、事务管理器、JDBC 驱动和数据库端等待信息。
第二个误区是认为 readOnly = true 会阻止所有写 SQL。验证时不要只看注解,而要在目标数据库和实际事务管理器下执行一次受控测试,观察写操作是否被拒绝、是否仍然执行,以及 ORM 是否提前 flush。
@Transactional(readOnly = true)
public void accidentalWrite(long orderId) {
repository.updateStatus(orderId, "PAID");
}预期结果
代码能够被 Spring 代理调用,但 updateStatus 是否被数据库拒绝不能仅凭 readOnly = true 推断。
实际结果必须以所使用的事务管理器、驱动、数据库和 ORM 的测试结果为准。把 timeout 当成事务生命周期门禁,把 readOnly 当成资源访问意图,是最稳妥的使用方式;真正的查询超时、锁等待上限和写入禁止仍要在对应层次配置与验证。