Spring Boot 3.0.2中@ControllerAdvice响应被BasicErrorController覆盖求助

• 调整自定义异常处理器优先级
  给你的@ControllerAdvice类添加@Order(Ordered.HIGHEST_PRECEDENCE)注解，确保它的优先级高于BasicErrorController。Spring会优先调用高优先级的异常处理器，避免请求被BasicErrorController接管。

• 检查依赖差异
  对比正常运行的项目，排查当前项目是否引入了额外的依赖（如spring-boot-starter-actuator、第三方链路追踪框架等）。部分依赖会修改默认的异常处理链，导致自定义处理器失效。移除或调整可疑依赖后重新测试。

• 核对错误处理相关配置
  检查application.yml/application.properties中的错误配置项：

  • 确保没有设置server.error.path与你的业务请求路径冲突；
  • 可以尝试设置server.error.whitelabel.enabled=false关闭默认白页错误处理；
  • 检查server.error.include-exception、server.error.include-stacktrace等参数是否影响响应结构。

• 确认自定义处理器被Spring扫描
  确保@ControllerAdvice所在类处于Spring的组件扫描范围内：

  • 类所在包需包含在主启动类的@ComponentScan路径下；
  • 若不在默认路径，可通过@ControllerAdvice(basePackages = "com.your.package")指定要处理的控制器范围。

• 验证handleExceptionInternal调用正确性
  检查调用handleExceptionInternal时的参数：

  • 确保status参数传递的是正确的状态码（如HttpStatus.BAD_REQUEST）；
  • 确认headers、request参数未被错误修改，保证响应体正常构建。

• 调试异常处理流程
  在handleMethodArgumentNotValid方法中添加日志或断点：

  • 确认方法是否被执行：若未执行，说明异常未被捕获，需检查异常类型匹配或优先级设置；
  • 若方法执行但响应被覆盖，排查后续是否有其他异常处理器干预了响应结果。

• 排除BasicErrorController自动配置（谨慎使用）
  若上述方法无效，可在主启动类添加@EnableAutoConfiguration(exclude = {ErrorMvcAutoConfiguration.class})，禁用默认的错误Mvc自动配置。但此操作会完全接管所有错误场景，需要确保自定义处理器能覆盖所有异常类型。

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