Spring Boot集成jOOQ未加@Transactional时实体插入失效问题

插入不生效的直接原因是自定义Hikari数据源时手动配置了config.setAutoCommit(false);：

• 方法添加@Transactional注解时，Spring事务切面会接管连接的事务生命周期，方法正常执行完成后自动提交事务，抛出异常时回滚，因此数据可以正常写入数据库
• 无@Transactional注解时，没有组件负责触发事务提交操作，数据库连接默认关闭自动提交，执行完的INSERT语句仅停留在当前连接的未提交事务中，连接被归还到HikariCP连接池时，未提交的事务会被自动回滚，因此会出现日志打印了SQL执行记录、但数据库无对应数据的现象
• 整套手动定义的jOOQ相关Bean覆盖了Spring Boot jOOQ Starter的默认自动配置，默认配置已经做了事务适配，不会出现这类事务边界不匹配的问题。

两种方案二选一，优先选择第一种：

• 移除config.setAutoCommit(false);配置项，保留HikariCP默认的autoCommit=true行为即可。Spring事务管理器在开启声明式事务时，会自动将当前连接的autoCommit临时修改为false，事务结束后自动恢复原值，不会和@Transactional注解的逻辑冲突；无事务的单条SQL执行完成后会自动提交，符合常规使用预期。
• 如果有特殊场景必须保留数据源层面的autoCommit=false配置，需要保证所有写操作、需要一致性读的查询操作都包裹在事务边界内，除了添加@Transactional注解，也可以用已经配置的TransactionTemplate实现编程式事务：

transactionTemplate.execute(transactionStatus -> {
    userRepository.insert(entity);
    return null;
});

该方案需要手动给所有数据操作加事务边界，侵入性更高，不推荐使用。

使用jOOQ官方Spring Boot Starter时，不需要手动编写PersistenceConfig中定义的全套Bean：

• 数据源、事务管理器、DSLContext、ConnectionProvider、事务处理器、SQL异常转换器等组件，Starter都会完成自动装配，手动重复定义反而容易出现配置逻辑不兼容的问题
• 如果需要调整HikariCP连接池参数，直接在配置文件中通过spring.datasource.hikari.*前缀配置即可，无需手动编写DataSource初始化逻辑。

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