Quarkus全局异常处理器覆盖数据库事务回滚问题

你遇到的问题是因为Quarkus的@Transactional注解默认仅在方法抛出未被捕获的RuntimeException/Error时触发事务回滚。当全局异常处理器（JAX-RS ExceptionMapper）捕获了异常，事务拦截器无法感知到方法抛出了异常，会默认认为事务执行成功并提交。

1. 在全局异常处理器中手动回滚事务 #

注入TransactionManager，在处理异常时主动检查事务状态并触发回滚：

import jakarta.transaction.TransactionManager;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class CustomExceptionHandler implements ExceptionMapper<YourBusinessException> {

    @Inject
    TransactionManager txManager;

    @Override
    public Response toResponse(YourBusinessException exception) {
        // 检查事务是否处于活跃状态，若则回滚
        try {
            if (txManager.getStatus() == jakarta.transaction.Status.STATUS_ACTIVE) {
                txManager.rollback();
            }
        } catch (Exception rollbackEx) {
            // 可选：记录回滚失败日志
        }
        
        return Response.status(Response.Status.BAD_REQUEST)
                .entity(exception.getMessage())
                .build();
    }
}

注意：仅对需要触发回滚的异常类型执行此操作，避免误回滚正常事务。

2. 拆分事务到服务层（推荐） #

将CRUD逻辑迁移至单独的服务类，在服务方法上标注@Transactional，控制器层仅处理请求和响应，不承担事务职责。这样即使控制器捕获了异常，服务层的事务会因异常抛出自动回滚：

// 服务类
@ApplicationScoped
public class EntityService {

    @Transactional
    public void updateEntity(YourEntity entity) {
        // 执行数据库操作
        if (entity.isInvalid()) {
            throw new YourBusinessException("实体参数无效");
        }
        entity.persist();
    }
}

// 控制器类
@Path("/entities")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class EntityResource {

    @Inject
    EntityService entityService;

    @PUT
    public Response updateEntity(YourEntity entity) {
        try {
            entityService.updateEntity(entity);
            return Response.ok().build();
        } catch (YourBusinessException e) {
            return Response.status(Response.Status.BAD_REQUEST)
                    .entity(e.getMessage())
                    .build();
        }
    }
}

这种方式符合分层架构设计，事务边界更清晰，避免控制器层事务带来的耦合问题。

3. 配置@Transactional的rollbackOn属性 #

若需在控制器层保留事务，可通过rollbackOn指定需要触发回滚的异常类型。即使异常被全局处理器捕获，事务拦截器仍会自动回滚：

@Path("/entities")
@Transactional(rollbackOn = YourBusinessException.class)
public class EntityResource {

    @PUT
    public Response updateEntity(YourEntity entity) {
        if (entity.isInvalid()) {
            throw new YourBusinessException("实体参数无效");
        }
        entity.persist();
        return Response.ok().build();
    }
}

注意：此属性需Quarkus 2.0及以上版本支持，且需确保异常类型匹配准确。

Quarkus的CDI事务拦截器会在方法执行完成后检查状态：

• 若方法抛出RuntimeException/Error（默认）或rollbackOn指定的异常，拦截器触发回滚；
• 若异常被方法内部捕获并处理（或被全局处理器捕获后未向外传播），拦截器会认为事务执行正常，自动提交。

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