SpringBoot统一处理异常

最新推荐文章于 2025-08-22 13:45:39 发布

weixin_33912445

最新推荐文章于 2025-08-22 13:45:39 发布

阅读量98

点赞数

CC 4.0 BY-SA版权

文章标签： java ui

原文链接：https://juejin.im/post/5ae42aaa51882567382f591a

本文介绍如何在SpringBoot项目中实现异常的统一处理，通过自定义控制器实现ErrorController接口，可以针对不同类型的错误进行定制化的响应。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在springboot项目，报错有着默认的提示，这篇文章介绍一下如何统一处理异常。

新建项目，pom文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.dalaoyang</groupId>
    <artifactId>springboot_error</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>springboot_error</name>
    <description>springboot_error</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.9.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>


</project>
复制代码

创建一个IndexController，里面写两个方法，index方法正常跳转，test方法是故意写的一个nullpoint的错误的方法。代码如下：

package com.dalaoyang.Controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Map;

/**
 * @author dalaoyang
 * @Description
 * @project springboot_learn
 * @package com.dalaoyang.Controller
 * @email yangyang@dalaoyang.cn
 * @date 2018/4/28
 */
@RestController
public class IndexController {

    @RequestMapping("/")
    public String index(){
        return "index";
    }

    @RequestMapping("/test")
    public String test(){
        Map map = null;
        return map.toString();
    }
}
复制代码

启动项目访问http://localhost:8080/，如下图，没有任何问题

然后随便访问一个项目里没有的地址，比如http://localhost:8080/aaa，如下图所示，404没有找到：

访问http://localhost:8080/test，如下图500错误：

从图上可以看到，springboot报错的时候都在找/error这个地址，这时我们新建一个CommonErrorController来统一处理异常，这个类实现了ErrorController，代码如下：

package com.dalaoyang.Controller;

import org.springframework.boot.autoconfigure.web.ErrorController;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author dalaoyang
 * @Description
 * @project springboot_learn
 * @package com.dalaoyang.Controller
 * @email yangyang@dalaoyang.cn
 * @date 2018/4/28
 */
@RestController
public class CommonErrorController implements ErrorController {

    private final String ERROR_PATH = "/error";


    @Override
    public String getErrorPath() {
        return ERROR_PATH;
    }

    @RequestMapping(value = ERROR_PATH)
    public String handleError(){
        System.out.println(getErrorPath());
        return "error";
    }
}
复制代码

重启项目，在访问http://localhost:8080/aaa和http://localhost:8080/test就都返回"error"字符串了，如下：

源码下载：大老杨码云

个人网站：dalaoyang.cn