Spring Boot 3集成JOOQ事务回滚失效问题求助

问题描述 #

在Spring Boot 3集成jOOQ开发多数据库操作时，已在服务方法标记@Transactional注解，但事务未正常回滚：执行三张表插入操作时，最后一张表插入抛出SQL异常，前两张表的记录未被回滚。

现有配置 #

依赖配置 #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jooq</artifactId>
</dependency>

jOOQ配置类 #

@Configuration
@RequiredArgsConstructor
@EnableTransactionManagement
public class JooqConfiguration {

    private final DataSource dataSource;

    @Bean
    public DataSourceConnectionProvider connectionProvider() {
        return new DataSourceConnectionProvider(new TransactionAwareDataSourceProxy(dataSource));
    }

    @Bean
    public DefaultDSLContext context() {
        return new DefaultDSLContext(configuration());
    }

    public DefaultConfiguration configuration() {
        DefaultConfiguration jooqConfiguration = new DefaultConfiguration();
        jooqConfiguration.setDataSource(dataSource);
        jooqConfiguration.setSQLDialect(SQLDialect.POSTGRES);
        jooqConfiguration.setSettings(new Settings().withExecuteWithOptimisticLocking(true));

        return jooqConfiguration;
    }
}

解决方案及原因分析 #

1. 修复jOOQ配置类核心问题 #

核心错误：配置的connectionProvider()未被注入到jOOQ的DefaultConfiguration中，导致jOOQ直接使用原始数据源，脱离Spring事务上下文。

修改后的配置类：

@Configuration
@RequiredArgsConstructor
@EnableTransactionManagement
public class JooqConfiguration {

    private final DataSource dataSource;

    @Bean
    public DataSourceConnectionProvider connectionProvider() {
        return new DataSourceConnectionProvider(new TransactionAwareDataSourceProxy(dataSource));
    }

    @Bean
    public DefaultDSLContext context() {
        return new DefaultDSLContext(configuration());
    }

    @Bean
    public DefaultConfiguration configuration() {
        DefaultConfiguration jooqConfiguration = new DefaultConfiguration();
        // 替换直接设置dataSource，改为注入事务感知的connectionProvider
        jooqConfiguration.set(connectionProvider());
        jooqConfiguration.setSQLDialect(SQLDialect.POSTGRES);
        jooqConfiguration.setSettings(new Settings().withExecuteWithOptimisticLocking(true));

        return jooqConfiguration;
    }
}

2. 检查@Transactional注解的使用规范 #

• 确保标注@Transactional的方法是public权限：Spring事务代理仅对public方法生效
• 服务类需被Spring容器管理：类上添加@Service或@Component注解
• 避免同一类内部调用事务方法：Spring AOP基于代理实现，内部调用不会触发事务代理逻辑

3. 确认异常回滚规则 #

Spring默认仅对RuntimeException和Error触发事务回滚。若抛出的是Checked Exception，需在注解中指定回滚规则：

@Transactional(rollbackFor = Exception.class)

关键原理说明 #

• TransactionAwareDataSourceProxy会将数据库连接绑定到当前Spring事务上下文，确保所有操作共享同一事务
• DataSourceConnectionProvider负责将事务感知的连接提供者传递给jOOQ，让jOOQ的数据库操作纳入Spring事务管理范畴

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