SpringBoot异常处理机制

在SpringBoot中，常用的异常处理有两种，一种是BasicErrorController，另一种是@ControllerAdvice，BasicErrorController用于处理非Controller抛出的异常，而@ControllerAdvice用于处理Controller抛出的异常，对于非Controller抛出的异常它是不会管的。但是，如果是Controller层调用Service层，从Service层抛出，依然会抛到Controller，所以还是会调用@ControllerAdvice进行处理

以BasicErrorController为例，我们如何去创建一个自定的异常处理类呐？

BasicErrorController创建及配置

创建代码类并继承BasicErrorController

代码类

public class MyErrorController extends BasicErrorController {


    public MyErrorController(ErrorAttributes errorAttributes, ErrorProperties errorProperties, List<ErrorViewResolver> errorViewResolvers) {
        super(errorAttributes, errorProperties, errorViewResolvers);
    }

    @SneakyThrows
    @Override
    protected Map<String, Object> getErrorAttributes(HttpServletRequest request, boolean includeStackTrace) {

        Map<String, Object> attributes = super.getErrorAttributes(request, includeStackTrace);
        attributes.remove("timestamp");
        attributes.remove("status");
        attributes.remove("error");
        attributes.remove("exception");
        attributes.remove("path");
        String messageCode = (String) attributes.get("message");
        ErrorEnum errorEnum = null;
        try {
            errorEnum = ErrorEnum.getEnumByCode(messageCode);
        } catch (Exception e) {
            e.printStackTrace();
        }

        if (errorEnum==null){

            attributes.put("type","0");
            attributes.put("message","枚举类异常");
            return attributes;

        }

        attributes.put("errorControllerType","basicErrorController");
        attributes.put("type",errorEnum.getCode());
        attributes.put("message",errorEnum.getMessage());
        return attributes;
    }
}

配置MyErrorController

首先我们知道SpringBoot的大部分配置可以在ErrorMvcAutoConfiguration中找到，打开ErrorMvcAutoConfiguration源码，可以看到ErrorMvcAutoConfiguration中对

BasicErrorController进行了配置，为此在继承BasicErrorController后也应当对继承类进行配置。

ErrorMvcAutoConfiguration中的BasicErrorController配置如下

@Bean
	@ConditionalOnMissingBean(value = ErrorController.class, search = SearchStrategy.CURRENT)
	public BasicErrorController basicErrorController(ErrorAttributes errorAttributes) {
		return new BasicErrorController(errorAttributes, this.serverProperties.getError(), this.errorViewResolvers);
	}

我们知道，需要ErrorAttributes errorAttributes, ErrorProperties errorProperties, List errorViewResolvers，三个参数，而ErrorMvcAutoConfiguration源码中配置中只有ErrorAttributes errorAttributes一个参数，而另外一个参数则在new BasicErrorController(errorAttributes, this.serverProperties.getError(), this.errorViewResolvers) 中找到，即his.serverProperties.getError(),最后一个参数点两下，可以知道在ErrorMvcAutoConfiguration构造函数中，即this.errorViewResolvers = errorViewResolvers.orderedStream().collect(Collectors.toList());

public ErrorMvcAutoConfiguration(ServerProperties serverProperties, DispatcherServletPath dispatcherServletPath,
			ObjectProvider<ErrorViewResolver> errorViewResolvers) {
		this.serverProperties = serverProperties;
		this.dispatcherServletPath = dispatcherServletPath;
		this.errorViewResolvers = errorViewResolvers.orderedStream().collect(Collectors.toList());
	}

配置类

@Configuration
public class ErrorConfiguration {

    @Bean
    public MyErrorController basicErrorController(ErrorAttributes errorAttributes, ServerProperties serverProperties,
                                                  ObjectProvider<List<ErrorViewResolver>> errorViewResolversProvider) {
        return new MyErrorController(errorAttributes, serverProperties.getError(),
                errorViewResolversProvider.getIfAvailable());
    }


}

@AdviceController

@ControllerAdvice
public class ExceptionHandler {

    @org.springframework.web.bind.annotation.ExceptionHandler(Exception.class)
    @ResponseBody
    public Result exceptionHandler(Exception e){

        e.printStackTrace();
        return new Result(StatusCode.ERROR,e.getMessage());

    }

}

拦截器异常&&URL存在，因为URL对应的controller是存在的，所以可以自定义异常处理器，返回前端自定义的协议数据，但是如果没有异常处理器 ，就会出现以下信息。

<!doctype html>
<html lang="en">

<head>
	<title>HTTP Status 500 – Internal Server Error</title>
	<style type="text/css">
		h1 {
			font-family: Tahoma, Arial, sans-serif;
			color: white;
			background-color: #525D76;
			font-size: 22px;
		}

		h2 {
			font-family: Tahoma, Arial, sans-serif;
			color: white;
			background-color: #525D76;
			font-size: 16px;
		}

		h3 {
			font-family: Tahoma, Arial, sans-serif;
			color: white;
			background-color: #525D76;
			font-size: 14px;
		}

		body {
			font-family: Tahoma, Arial, sans-serif;
			color: black;
			background-color: white;
		}

		b {
			font-family: Tahoma, Arial, sans-serif;
			color: white;
			background-color: #525D76;
		}

		p {
			font-family: Tahoma, Arial, sans-serif;
			background: white;
			color: black;
			font-size: 12px;
		}

		a {
			color: black;
		}

		a.name {
			color: black;
		}

		.line {
			height: 1px;
			background-color: #525D76;
			border: none;
		}
	</style>
</head>

<body>
	<h1>HTTP Status 500 – Internal Server Error</h1>
</body>

</html>

统一异常处理的使用:
大多数请情况下，不要去继承重写，BasicErrorController，使用@ControllerAdvice已经是够用的了，因为你的所有请求都会经过Controller

1.拦截器抛出异常，要记得要使url存在，url不存在，会抛出HTTP Status 500 – Internal Server Error异常，尽量不要在拦截器中抛异常吧
2.扩展 org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice 检测返回对象，必要时替换掉
3.拦截器中检测，response 状态码，重写异常数据

Logo
2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

cover

2026工作手机系统好的企业

avatar 2048 AI社区

Linux 环境下静态链接库 (.a) & 动态链接库 (.so) 完整实例（含嵌入式适配）

静态库 (.a)gcc -c 生成.o→ar rcs 打包为.a→gcc 编译测试程序 -I/-L/-l；特性：无外部依赖、体积大、更新需重编译，嵌入式首选；动态库 (.so)gcc -c -fPIC 生成.o→gcc -shared 生成.so→gcc 编译测试程序 -I/-L/-l -Wl,-rpath；特性：依赖外部库、体积小、支持热更新，PC/Linux 服务器首选；嵌入式适配只需替换为

avatar 2048 AI社区

RegexBox：让正则表达式变得简单，AI 驱动的正则工具箱

正则表达式曾经是开发者的噩梦，但现在，有了 RegexBox，它将成为你的得力助手！🤖AI 加持：不会写？让 AI 帮你写📚模板丰富：不想写？直接用模板⚡实时测试：写错了？立即看到结果📖规则速查：忘记了？内置参考手册不再为正则表达式而烦恼，专注于你的核心业务逻辑！🚀 立即体验 RegexBox，让正则表达式变得简单！让我们告别"复制粘贴式"的正则表达式开发，拥抱 AI 时代的编程体验！本文

avatar 2048 AI社区