springbootspringboot工作总结SpringHome

springboot异常处理

2017-07-29  本文已影响799人  二月_春风

前言

在springboot项目中，一般我们访问不存在的资源或内部服务报错，会报下面的异常页面，这是springboot为我们定制的异常页面，

404

定义一个项目，加入依赖：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
</dependencies>

定义一个Controller类，

package com.zhihao.miao.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    private Logger logger = LoggerFactory.getLogger(getClass());

    @GetMapping("/user/home")
    public String index(){
        logger.info("user home");
        return "user home";
    }

    @GetMapping("/user/help")
    public String help(){
        logger.info("user help");
        throw new IllegalArgumentException("args is empty");
    }
}

启动类启动：

package com.zhihao.miao;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
}

访问不存在的资源


404

访问内部资源报错的资源


500

如何去掉springboot默认的异常处理逻辑
查看org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration类，


发现org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration类就是springboot默认的异常处理逻辑，我们在springboot应用容器中去除这个类即可去掉springboot默认的异常处理逻辑。

修改启动类，排除ErrorMvcAutoConfiguration类

package com.zhihao.miao;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration;

@SpringBootApplication(exclude =ErrorMvcAutoConfiguration.class)
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
}

再次访问上面的资源就出现经典的tomcat异常


404 500

如何定制自己的异常页面

使用ErrorPageRegistrar方法
写一个类，实现ErrorPageRegistrar接口，然后实现registerErrorPages方法，在该方法里面，添加具体的错误处理逻辑(类似web.xml里面配置错误处理方式)，这一种也是全局的异常处理。

定义一个MyErrorPageRegistrar实现ErrorPageRegistrar接口

package com.zhihao.miao.bean;

import org.springframework.boot.web.servlet.ErrorPage;
import org.springframework.boot.web.servlet.ErrorPageRegistrar;
import org.springframework.boot.web.servlet.ErrorPageRegistry;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;

@Component
public class MyErrorPageRegistrar implements ErrorPageRegistrar {

    @Override
    public void registerErrorPages(ErrorPageRegistry registry) {
        //具体的错误码错误异常页面
        ErrorPage e404 = new ErrorPage(HttpStatus.NOT_FOUND,"/404.html");
        ErrorPage e500 = new ErrorPage(HttpStatus.INTERNAL_SERVER_ERROR,"/500.html");
        //指定具体异常的错误定制页面
        ErrorPage argspage = new ErrorPage(IllegalArgumentException.class,"/argsException.html");
        registry.addErrorPages(e404,e500,argspage);
    }
}

定义的3个错误页面，
404.html:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Insert title here</title>
</head>
<body>
<h1>404 not found</h1>
</body>
</html>

500.html:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Insert title here</title>
</head>
<body>
<h1>500 server error</h1>
</body>
</html>

argsException.html:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Insert title here</title>
</head>
<body>
<h1>args is empty</h1>
</body>
</html>

启动类,可以不指定排除默认的springboot异常处理，因为新定义的全局异常处理springboot的就不执行了

package com.zhihao.miao;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration;

//@SpringBootApplication(exclude =ErrorMvcAutoConfiguration.class)
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
}

再去访问之前的资源

资源不存在


404 IllegalArgumentException

发现具体异常定义的异常处理优于状态码异常处理。

使用@ExceptionHandler注解
新建一个项目，定义一个Controller进行测试，

package com.zhihao.miao.controller;

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.FileNotFoundException;

@RestController
public class BookController {

    //对异常进行处理，这种方式只能处理当前类中的异常,也就是局部异常处理
    @ExceptionHandler(value=FileNotFoundException.class)
    public String error(){
        return "file is not found exception";
    }

    @ExceptionHandler(value=Exception.class)
    public String excep(Exception e){
        return "not found exception: "+e.getMessage();
    }

    @GetMapping("/book/error1")
    public String error1() throws FileNotFoundException {
        throw new FileNotFoundException("book.txt not found");
    }

    @GetMapping("/book/error2")
    public String error2() throws ClassNotFoundException {
        throw new ClassNotFoundException("Book class not found");
    }

}

启动类启动：

package com.zhihao.miao;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
}

访问http://localhost:8080/book/error1，抛出FileNotFoundException异常，被当前类的@ExceptionHandler注解给捕获到进行异常逻辑处理。定义在其他Controller类中的此种异常不会被其捕获，所以此种异常处理也是局部异常处理。

使用@ControllerAdvice注解定义全局异常

定义GlobalExceptionHandler标记注解@ControllerAdvice

package com.zhihao.miao.bean;

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * 可以在全局异常处理的类中进行具体的异常处理，也可以在全局异常类中进行所有异常的处理，
 * @ExceptionHandler的value值不同。
 */
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    @ResponseBody
    public String ArithmeticHandler(Exception e){
        return "global error " + e.getClass().getName();
    }

    @ExceptionHandler(Exception.class)
    @ResponseBody
    public String error(Exception e){
        return "global error" + e.getMessage();
    }
}

定义Controller

@RestController
public class UserController {

    private Logger logger = LoggerFactory.getLogger(getClass());

    @GetMapping("/user/home")
    public String index(){
        logger.info("user home");
        return "user home";
    }

    @GetMapping("/user/help")
    public String help(){
        logger.info("user help");
        throw new IllegalArgumentException("args is empty");
    }
}

访问http://localhost:8080/user/help

这个处理异常的方法必须要求本身的方法返回参数和@ExceptionHandler(***Exception.class)异常修饰的方法必须要一样的。

总结这种异常处理的步骤：
写一个类，需要加上@ControllerAdvice注解，然后使用@ExceptionHandler异常进行异常定位。
如果一个Controller类中定义了@ExceptionHandler注解修饰的方法，那么当前类中异常捕获优先于全局定义的异常。

上一篇 下一篇

猜你喜欢

热点阅读