Spring Boot中@Transactional的timeout属性不生效问题排查

为什么@Transactional(timeout)不生效 #

你使用的@Transactional(readOnly = true, timeout = 1)是事务级别的超时控制，它仅限制整个事务的总执行时长，而非单个SQL查询的运行时间。Spring的事务超时机制仅在事务提交/回滚阶段检查是否超时，无法主动中断正在数据库中执行的SQL语句——只要SQL还在运行，事务就不会触发超时判断，自然不会抛出异常。

正确实现查询超时的方法 #

要控制单个SELECT查询的执行时长，需要配置JDBC驱动层面的查询超时，通过给JdbcTemplate设置queryTimeout属性实现，有两种可行方式：

方式1：全局配置JdbcTemplate（推荐） #

在Spring配置类中定义JdbcTemplate和NamedParameterJdbcTemplate的Bean，统一设置查询超时：

@Configuration
public class JdbcConfig {
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);
        jdbcTemplate.setQueryTimeout(1); // 超时时间，单位：秒
        return jdbcTemplate;
    }

    @Bean
    public NamedParameterJdbcTemplate namedParameterJdbcTemplate(JdbcTemplate jdbcTemplate) {
        return new NamedParameterJdbcTemplate(jdbcTemplate);
    }
}

配置完成后，所有通过该JdbcTemplate执行的SQL查询都会自动应用1秒超时规则，一旦查询超时，数据库驱动会直接抛出SQLException。

方式2：单个查询单独设置超时 #

如果不需要全局统一配置，可在特定查询中手动设置超时：

// 修改UserExportDao的findByExportFlag方法
@Transactional(readOnly = true) // 保留事务只读属性（若需事务），移除事务timeout
public List<UserExportCustom> findByExportFlag(Integer exportFlag, String query) {
    List<UserExportCustom> userExportCustomList = null;
    try {
        SqlParameterSource namedParameters = new MapSqlParameterSource()
                .addValue("exportFlag", exportFlag, Types.INTEGER);
        
        userExportCustomList = namedParameterJdbcTemplate.execute(query, namedParameters, 
            (PreparedStatementCallback<List<UserExportCustom>>) ps -> {
                ps.setQueryTimeout(1); // 给当前查询单独设置1秒超时
                ResultSet rs = ps.executeQuery();
                return userExportCustomRowMapper.mapRows(rs);
            });
    } catch (Exception e) {
        e.printStackTrace();
        log.error("Error in findByExportFlag: \n" + e);
    }
    return userExportCustomList;
}

注意事项 #

• 确保使用的数据库驱动支持查询超时（如MySQL、PostgreSQL的官方驱动均原生支持），部分小众数据库可能需要额外配置。
• 若同时需要事务总时长控制，可保留@Transactional(timeout)，但它仅作用于事务生命周期，查询超时仍需通过JdbcTemplate配置实现。

内容的提问来源于stack exchange，提问作者Rahul