Spring Boot中自定义404异常处理问题学习笔记

1. 问题背景

在Spring Boot项目中，需要手动返回404异常给前端。为此，我创建了一个自定义的404异常类UnauthorizedAccessException，并在全局异常处理器GlobalExceptionHandler中处理该异常。然而，在使用Postman测试时，返回的仍然是500错误，而不是预期的404错误。

2. 代码实现

2.1 自定义404异常类

package cn.jbolt.config.exception;import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;/*** 自定义无权限访问的异常*/
@ResponseStatus(HttpStatus.NOT_FOUND)
public class UnauthorizedAccessException extends RuntimeException {private final HttpStatus status;public UnauthorizedAccessException(String message) {super(message);this.status = HttpStatus.NOT_FOUND;}public HttpStatus getStatus() {return status;}
}

2.2 全局异常处理器

package cn.jbolt.config.exception;import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;@RestControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(UnauthorizedAccessException.class)public ResponseEntity<String> handleUnauthorizedAccessException(UnauthorizedAccessException ex) {System.out.println("UnauthorizedAccessException-------------------------: " + ex.getMessage());HttpStatus status = ex.getStatus();String message = ex.getMessage();return new ResponseEntity<>(message, status);}
}

2.3 过滤器中抛出自定义异常

package cn.jbolt.teaching_tools.school;import cn.jbolt.config.exception.UnauthorizedAccessException;
import cn.jbolt.teaching_tools.school.entity.School;
import cn.jbolt.teaching_tools.school.service.SchoolService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class SchoolContextFilter implements Filter {@Autowiredprivate SchoolService schoolService;@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)throws IOException, ServletException {HttpServletRequest httpRequest = (HttpServletRequest) request;HttpServletResponse httpResponse = (HttpServletResponse) response;try {// 从域名获取学校信息String serverName = httpRequest.getServerName();String[] domainParts = serverName.split("\\.");if (domainParts.length >= 3) {String subdomain = domainParts[0];// 查询学校IDSchool school = schoolService.getByDomain(subdomain);if (school != null) {// 设置到SchoolContextHolder和请求属性SchoolContextHolder.setSchoolId(school.getId().toString());} else {// 如果找不到学校，抛出异常throw new UnauthorizedAccessException("异常域名");}} else {// 如果不是二级域名，抛出异常throw new UnauthorizedAccessException("异常域名");}chain.doFilter(request, response);} catch (UnauthorizedAccessException ex) {// 手动处理异常，写入响应httpResponse.setStatus(HttpStatus.NOT_FOUND.value());httpResponse.setContentType("application/json;charset=UTF-8");httpResponse.getWriter().write("{\"timestamp\": " + System.currentTimeMillis() + ", \"status\": 404, \"error\": \"Not Found\", \"message\": \"" + ex.getMessage() + "\", \"path\": \"" + httpRequest.getRequestURI() + "\"}");} finally {SchoolContextHolder.clear();}}
}

3. 问题分析

3.1 Filter抛出的异常未被Spring MVC捕获

在Spring Boot中，Filter是Servlet API的一部分，而Spring MVC的全局异常处理器（@ControllerAdvice或@RestControllerAdvice）只能捕获Spring MVC控制器中抛出的异常。因此，当Filter抛出异常时，Spring MVC的全局异常处理器无法捕获，导致返回了500错误。

3.2 @RestControllerAdvice未正确扫描

如果GlobalExceptionHandler类所在的包没有被Spring Boot扫描到，它将无法生效。确保GlobalExceptionHandler类所在的包在Spring Boot的扫描路径内。

3.3 Spring Boot的默认错误处理机制

Spring Boot的默认错误处理机制可能会覆盖自定义的异常处理逻辑。可以通过配置application.properties或application.yml文件来调整默认错误处理行为。

4. 解决方案

4.1 在Filter中手动处理异常

由于Filter抛出的异常无法被Spring MVC的全局异常处理器捕获，因此需要在Filter中手动处理异常，将异常信息写入响应中。具体实现如下：

@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)throws IOException, ServletException {HttpServletRequest httpRequest = (HttpServletRequest) request;HttpServletResponse httpResponse = (HttpServletResponse) response;try {// 从域名获取学校信息String serverName = httpRequest.getServerName();String[] domainParts = serverName.split("\\.");if (domainParts.length >= 3) {String subdomain = domainParts[0];// 查询学校IDSchool school = schoolService.getByDomain(subdomain);if (school != null) {// 设置到SchoolContextHolder和请求属性SchoolContextHolder.setSchoolId(school.getId().toString());} else {// 如果找不到学校，抛出异常throw new UnauthorizedAccessException("异常域名");}} else {// 如果不是二级域名，抛出异常throw new UnauthorizedAccessException("异常域名");}chain.doFilter(request, response);} catch (UnauthorizedAccessException ex) {// 手动处理异常，写入响应httpResponse.setStatus(HttpStatus.NOT_FOUND.value());httpResponse.setContentType("application/json;charset=UTF-8");httpResponse.getWriter().write("{\"timestamp\": " + System.currentTimeMillis() + ", \"status\": 404, \"error\": \"Not Found\", \"message\": \"" + ex.getMessage() + "\", \"path\": \"" + httpRequest.getRequestURI() + "\"}");} finally {SchoolContextHolder.clear();}
}

4.2 确保@RestControllerAdvice被正确扫描

确保GlobalExceptionHandler类所在的包在Spring Boot的扫描路径内。例如：

@SpringBootApplication(scanBasePackages = "cn.jbolt")
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}
}

4.3 调整Spring Boot的默认错误处理机制

可以通过配置application.properties或application.yml文件来调整默认错误处理行为。例如：

server.error.include-stacktrace=never
server.error.include-message=always
server.error.include-binding-errors=always
server.error.include-exception=false

5. 测试验证

5.1 测试用例

使用Postman测试以下两种场景：

  1. 正常请求：请求的域名和路径符合预期，应返回正常响应。

  2. 异常请求：请求的域名不符合预期，应返回404错误。

5.2 测试结果

  • 正常请求：返回正常响应。

  • 异常请求：返回404错误，响应内容如下：

    {"timestamp": 1745483881203,"status": 404,"error": "Not Found","message": "异常域名","path": "/auth/login"
}

6. 注意事项

6.1 异常处理的优先级

如果项目中有多个全局异常处理器，可能会导致异常处理逻辑被覆盖。确保自定义的异常处理逻辑优先级高于其他全局异常处理器。

6.2 日志记录

在全局异常处理器中添加日志记录，方便调试和排查问题。例如：

@ExceptionHandler(UnauthorizedAccessException.class)
public ResponseEntity<String> handleUnauthorizedAccessException(UnauthorizedAccessException ex) {System.out.println("UnauthorizedAccessException-------------------------: " + ex.getMessage());HttpStatus status = ex.getStatus();String message = ex.getMessage();return new ResponseEntity<>(message, status);
}

6.3 响应格式的统一

确保返回的响应格式与前端的要求一致。可以使用统一的错误响应类来封装错误信息，例如：

public class ErrorResponse {private Long timestamp;private int status;private String error;private String message;private String path;// Getters and Setters
}

然后在Filter中返回统一的错误响应：

httpResponse.getWriter().write(new ObjectMapper().writeValueAsString(new ErrorResponse(System.currentTimeMillis(), 404, "Not Found", ex.getMessage(), httpRequest.getRequestURI())));

7. 总结

通过在Filter中手动处理异常，确保返回给前端的响应是正确的404错误，而不是500错误。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/diannao/80354.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

你学会了些什么220622？--搭建UI自动化

你学会了些什么220622？--搭建UI自动化

jenkins访问地址&#xff1a;http://192.168.82.129:8080/ 账号密码&#xff1a;admin/a123456a ***** 什么是UI自动化** 使用工具或者脚本对需要测试的软件的前端界面在预设的条件下&#xff0c;在已有的测试数据下运行系统或者应用程序&#xff0c;并获取其前端页面UI显示的…
阅读更多...
【2025计算机网络-面试常问】http和https区别是什么，http的内容有哪些，https用的是对称加密还是非对称加密，流程是怎么样的

【2025计算机网络-面试常问】http和https区别是什么，http的内容有哪些，https用的是对称加密还是非对称加密，流程是怎么样的

HTTP与HTTPS全面对比及HTTPS加密流程详解 一、HTTP与HTTPS核心区别 特性HTTPHTTPS协议基础明文传输HTTP SSL/TLS加密层默认端口80443加密方式无加密混合加密&#xff08;非对称对称&#xff09;证书要求不需要需要CA颁发的数字证书安全性易被窃听、篡改、冒充防窃听、防篡改…
阅读更多...
JavaFX 第一篇 Hello World

JavaFX 第一篇 Hello World

1、简介 JavaFX 是一个用于构建客户端应用程序的 Java 库&#xff0c;作为 Java 标准库的一部分&#xff08;JDK 8 到 10&#xff09;&#xff0c;从 JDK 11 开始&#xff0c;JavaFX 将以独立模块发布&#xff0c;将不再包含在 JDK标准库中&#xff0c;他是 Java 应用程序开发的…
阅读更多...
SQL实战：02之连续数问题求解

SQL实战：02之连续数问题求解

文章目录 概述题目:体育馆的人流量题解步骤一&#xff1a;构造出一个连续序列步骤二&#xff1a;找出符合条件的组的序号步骤三&#xff1a;fetch结果&#xff0c;使用内连接过滤出符合条件的记录。完整SQL 题目二&#xff1a;连续出现的数字题解步骤一&#xff1a;分区并构建连…
阅读更多...
STM32 的 GPIO和中断

STM32 的 GPIO和中断

GPIO的简单介绍 内部结构 施密特触发器&#xff08;TTL肖特基触发器&#xff09; 的工作原理&#xff1a; 施密特触发电路&#xff08;简称&#xff09;是一种波形整形电路&#xff0c;当任何波形的信号进入电路时&#xff0c;输出在正、负饱和之间跳动&#xff0c;产生方波或…
阅读更多...
Server - 优雅的配置服务器 Bash 环境(.bashrc)

Server - 优雅的配置服务器 Bash 环境(.bashrc)

欢迎关注我的CSDN&#xff1a;https://spike.blog.csdn.net/ 本文地址&#xff1a;https://spike.blog.csdn.net/article/details/147335592 免责声明&#xff1a;本文来源于个人知识与公开资料&#xff0c;仅用于学术交流&#xff0c;欢迎讨论&#xff0c;不支持转载。 登录服…
阅读更多...
使用PyTorch实现图像增广与模型训练实战

使用PyTorch实现图像增广与模型训练实战

本文通过完整代码示例演示如何利用PyTorch和torchvision实现常用图像增广方法&#xff0c;并在CIFAR-10数据集上训练ResNet-18模型。我们将从基础图像变换到复杂数据增强策略逐步讲解&#xff0c;最终实现一个完整的训练流程。 一、图像增广基础操作 1.1 准备工作 #matplotli…
阅读更多...
解决Mac 安装 PyICU 依赖失败

解决Mac 安装 PyICU 依赖失败

失败日志&#xff1a; 解决办法 1、使用 homebrew 安装相关依赖 brew install icu4c 安装完成后&#xff0c;设置环境变量 echo export PATH"/opt/homebrew/opt/icu4c77/bin:$PATH" >> ~/.zshrcecho export PATH"/opt/homebrew/opt/icu4c77/sbin:$PATH…
阅读更多...
Springboot后端查询参数接收

Springboot后端查询参数接收

1.实现方式 假设前端发送的接口&#xff1a; /users?nameJohn&age30 后端怎么接收里面的name和age呢&#xff1f;以及再发别的参数后端怎么接收呢&#xff1f; 1.比较简单的方式 当控制器方法的参数类型是简单类型&#xff08;如 String、Integer、Long 等&#xff09…
阅读更多...
桌面应用中VUE使用新浏览器窗口打开页面

桌面应用中VUE使用新浏览器窗口打开页面

1、浏览器应用忽略此方式&#xff0c;可任意方式打开。针对桌面应用设置 newWindowClick(){try {this.fileUrl "";this.params.year ""this.params.date ""axios({method: post,url: /url/pdf/preview,data: this.params,}).then(res> {t…
阅读更多...
华为手机怎么进行音频降噪？音频降噪技巧分享：提升听觉体验

华为手机怎么进行音频降噪？音频降噪技巧分享：提升听觉体验

在当今数字化时代&#xff0c;音频质量对于提升用户体验至关重要&#xff0c;无论是在通话、视频录制还是音频文件播放中&#xff0c;清晰的音频都能带来更佳的听觉享受。 而华为手机凭借其强大的音频处理技术&#xff0c;为用户提供了多种音频降噪功能&#xff0c;帮助用户在…
阅读更多...
【数据可视化-22】脱发因素探索的可视化分析

【数据可视化-22】脱发因素探索的可视化分析

🧑 博主简介：曾任某智慧城市类企业算法总监，目前在美国市场的物流公司从事高级算法工程师一职，深耕人工智能领域，精通python数据挖掘、可视化、机器学习等，发表过AI相关的专利并多次在AI类比赛中获奖。CSDN人工智能领域的优质创作者，提供AI相关的技术咨询、项目开发和个…
阅读更多...
青少年编程与数学 02-018 C++数据结构与算法 06课题、树

青少年编程与数学 02-018 C++数据结构与算法 06课题、树

青少年编程与数学 02-018 C数据结构与算法 06课题、树 一、树(Tree)1. 树的定义2. 树的基本术语3. 常见的树类型4. 树的主要操作5. 树的应用 二、二叉树(Binary Tree)1. 二叉树的定义2. 二叉树的基本术语3. 二叉树的常见类型4. 二叉树的主要操作5. 二叉树的实现代码说明输出示例…
阅读更多...
【论文阅读】Visual Instruction Tuning

【论文阅读】Visual Instruction Tuning

文章目录 导言1、论文简介2、论文主要方法3、论文针对的问题4、论文创新点总结 导言 本论文介绍了一个新兴的多模态模型——LLaVA&#xff08;Large Language and Vision Assistant&#xff09;&#xff0c;旨在通过指令调优提升大型语言模型&#xff08;LLM&#xff09;在视觉…
阅读更多...
【学习笔记】Cadence电子设计全流程（三）Capture CIS 原理图绘制（下）

【学习笔记】Cadence电子设计全流程（三）Capture CIS 原理图绘制（下）

【学习笔记】Cadence电子设计全流程&#xff08;三&#xff09;Capture CIS 原理图绘制&#xff08;下&#xff09; 3.16 原理图中元件的编辑与更新3.17 原理图元件跳转与查找3.18 原理图常见错误设置于编译检查3.19 低版本原理图文件输出3.20 原理图文件的锁定与解锁3.21 Orca…
阅读更多...
js使用IntersectionObserver实现目标元素可见度的交互

js使用IntersectionObserver实现目标元素可见度的交互

文章目录 1、前言2、代码实现3、使用场景4、兼容性5、成熟的Hooks推荐 1、前言 IntersectionObserver 是浏览器原生提供的一个Api。可以"观察"我们的元素是否可见&#xff0c;原理是判断目标元素与可见区域的交叉比例&#xff0c;所以也被称为"交叉观察器"…
阅读更多...
linux 中断子系统 层级中断编程

linux 中断子系统 层级中断编程

虚拟中断控制器代码&#xff1a; #include<linux/kernel.h> #include<linux/module.h> #include<linux/clk.h> #include<linux/err.h> #include<linux/init.h> #include<linux/interrupt.h> #include<linux/io.h> #include<linu…
阅读更多...
虾皮（Shopee）商品详情 API 接口概述及 JSON 数据返回参考

虾皮（Shopee）商品详情 API 接口概述及 JSON 数据返回参考

前言 一、接口概述 Shopee 商品详情 API 接口是 Shopee 平台为开发者提供的&#xff0c;用于获取商品详细信息的接口服务。通过该接口&#xff0c;开发者可以获取商品的标题、价格、库存、描述、图片、规格参数、销量、评价等详细信息。这些数据为电商数据分析、商品比价工具…
阅读更多...
three.js中的instancedMesh类优化渲染多个同网格材质的模型

three.js中的instancedMesh类优化渲染多个同网格材质的模型

three.js小白的学习之路。 在上上一篇博客中&#xff0c;简单验证了一下three.js中的网格共享。写的时候就有一些想法&#xff0c;如果说某个场景中有一万棵树&#xff0c;这些树共享一个geometry和material&#xff0c;有没有好的办法将其进行一定程度上的渲染优化&#xff0…
阅读更多...
MySQL-自定义函数

MySQL-自定义函数

自定义函数 函数的作用 mysql数据库中已经提供了内置的函数&#xff0c;比如&#xff1a;sum&#xff0c;avg&#xff0c;concat等等&#xff0c;方便我们日常的使用&#xff0c;当需要时mysql支持定义自定义的函数&#xff0c;方便与我们对于需用复用的功能进行封装。 基本…
阅读更多...
最新文章

Copyright @ 2022~2023