Spring Boot如何扩展公共库异常切面实现应用专属的异常处理逻辑

你的初始方案核心思路可行，但存在两处明显缺陷：

1. 未禁用公共库的原有InternalExceptionAspect，会导致两个切面同时匹配相同切点，出现异常重复处理的问题
2. 两个切面@Order均为0时执行顺序不确定，若公共库切面先执行，会先把DuplicateKeyException包装为通用BadServerStateException，你的自定义分支将无法匹配到原异常类型。

针对需求有两种成熟实现方案，可根据你的实际场景选择：

方案1：继承重写+替换原有切面 #

适合需要批量修改原有异常处理逻辑的场景，完全复用公共库现有逻辑，代码集中度高。

实现步骤：

1. 先排除公共库切面的自动加载，避免双切面冲突：

@SpringBootApplication
@ComponentScan(excludeFilters = @ComponentScan.Filter(
        type = FilterType.ASSIGNABLE_TYPE,
        classes = InternalExceptionAspect.class
))
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

2. 实现自定义切面，不需要重复定义切点，直接复用父类逻辑即可：

@Aspect
@Order(0)
@Component
public class MyInternalExceptionAspect extends InternalExceptionAspect {

    @Override
    @AfterThrowing(pointcut = "applicationServicePointcut()", throwing = "e")
    public void translate(JoinPoint joinPoint, Throwable e) {
        // 优先处理自定义异常场景
        if (e instanceof DuplicateKeyException duplicateKeyException) {
            String resourceId = getResourceId();
            // 按业务需求抛出对应标准异常，抛完不需要再调用父类方法
            throw new BadRequestAlertException(
                    "唯一键冲突，数据已存在",
                    duplicateKeyException.getMessage(),
                    400,
                    resourceId,
                    "DUPLICATE_KEY"
            );
        }
        // 其余异常走原有公共逻辑
        super.translate(joinPoint, e);
    }
}

方案2：新增更高优先级的独立切面 #

适合仅需新增少量特殊异常处理的场景，侵入性最低，完全不影响公共库原有逻辑。

实现原理：

切面@Order值越小优先级越高，我们定义优先级高于公共库切面（Order=-1）的独立切面，专门处理DuplicateKeyException，处理完成后直接抛出公共库可识别的标准异常，公共库切面后续执行时会自动适配已有逻辑，不会重复包装。

实现代码：

@Aspect
@Order(-1) // 优先级高于公共库的@Order(0)
@Component
public class DuplicateKeyExceptionAspect {

    @Pointcut("@within(org.springframework.stereotype.Service)")
    public void servicePointcut() {}

    @AfterThrowing(pointcut = "servicePointcut()", throwing = "e")
    public void handleDuplicateKey(JoinPoint joinPoint, DuplicateKeyException e) {
        // 自定义处理逻辑，直接抛出公共库定义的标准异常即可
        RequestHeaders requestHeaders = RequestResponseContext.getRequestHeaders();
        String resourceId = requestHeaders.getResourceId();
        throw new BadRequestAlertException(
                "数据已存在",
                e.getMessage(),
                400,
                resourceId,
                "DUPLICATE_KEY"
        );
    }
}

选择建议 #

• 仅需处理DuplicateKeyException这一类特殊异常，优先选方案2，改动最小，和公共库完全解耦
• 还需要调整原有公共库的其他异常处理逻辑，选方案1，逻辑更统一易维护

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