Java 后端 / 系统课时

理解 timeout 与 readOnly

理解 timeout 与 readOnly

本课解决两个常被误用的事务属性:timeout 控制事务允许持续多久,readOnly 表示当前事务以只读意图参与执行。重点不是背参数,而是看清 Spring、事务管理器与数据库之间各自真正负责什么。

学习目标

  • 能解释 timeout 到期后谁发现超时、事务如何结束,以及为什么它不等于数据库锁等待的统一上限。
  • 能正确使用 readOnly,区分 Spring 层提示、JDBC 行为和数据库执行限制。
  • 能根据业务边界判断这两个属性该放在哪里,避免把它们当成性能或数据安全的万能开关。

timeout 到底限制什么

@Transactional(timeout = 5) 的核心含义是:该事务不能超过约 5 秒的事务超时时间。事务管理器会记录截止时间,后续参与同一事务的资源操作可以据此拒绝继续执行或触发超时。

它首先是 Spring 事务语义,而不是“任何数据库操作都必须恰好在 5 秒时被数据库杀掉”。实际效果取决于事务管理器、底层资源以及当前操作是否能应用事务超时。

例如,下面这个服务把一次订单读取和计算放进同一事务。timeout 应该贴着真实事务边界配置,而不是随便加在每个 DAO 方法上。

java
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) {
    }
}

预期结果

text
事务开始后,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。

java
@Transactional(readOnly = true)
public void accidentalWrite(long orderId) {
    repository.updateStatus(orderId, "PAID");
}

预期结果

text
代码能够被 Spring 代理调用,但 updateStatus 是否被数据库拒绝不能仅凭 readOnly = true 推断。
实际结果必须以所使用的事务管理器、驱动、数据库和 ORM 的测试结果为准。

把 timeout 当成事务生命周期门禁,把 readOnly 当成资源访问意图,是最稳妥的使用方式;真正的查询超时、锁等待上限和写入禁止仍要在对应层次配置与验证。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

理解 timeout 与 readOnly

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通