Spring MVC 中怎么捕获 404 异常并返回统一格式

老宇君_8438

老宇君_8438

2026-08-08

685人浏览

原创

spring mvc 默认不将404视为异常,需启用throw-exception-if-no-handler-found并配置静态资源路径隔离,使nohandlerfoundexception被@restcontrolleradvice捕获返回json;405同理需额外启用throw-exception-if-no-handler-found-for-method。

spring mvc 中怎么捕获 404 异常并返回统一格式

Spring MVC 默认不把 404 当作“异常”来处理,而是由 DispatcherServlet 直接返回 HTTP 404 响应(比如 Whitelabel 页面),所以它不会进入 @ExceptionHandler 流程。要让它被统一捕获并返回 JSON,关键不是“拦截 404”,而是**让 Spring 主动抛出 NoHandlerFoundException,再用全局异常处理器接住**。

启用 NoHandlerFoundException 抛出

这是前提。Spring Boot 默认静默处理未匹配路径,需显式开启异常抛出:

  • 在 application.yml 中添加:
spring:
  mvc:
    throw-exception-if-no-handler-found: true

⚠️ 单独配这一项通常无效——因为 Spring Boot 默认把 /error 路径也当作静态资源处理,导致请求仍被 BasicErrorController 拦截,根本不会触发该异常。

隔离静态资源路径

必须配合调整静态资源映射,避免 /error 被静态处理器“抢走”:

  • 推荐方式:限定静态资源只匹配特定前缀,例如:
spring:
  web:
    resources:
      add-mappings: true
  mvc:
    static-path-pattern: /static/**
    throw-exception-if-no-handler-found: true

这样,像 /api/user/123 这类非 /static/** 开头的请求,若无对应 Controller,就会真正抛出 NoHandlerFoundException。

js2java
js2java

JavaScript 到 Java 全栈翻译助手,专为前端开发者学习 Java 或快速实现后端业务逻辑而设计。当用户提到以下场景时必须使用此技能: - "帮我把这段 JS 代码转成 Java" - "用 Java 怎么写这个逻辑" - "我习惯用 JS 写,想翻译成 Java" - "教我 Java,我要写后端接...

下载
  • 替代方式(更彻底):禁用默认静态资源映射(适用于纯 API 服务):
spring:
  web:
    resources:
      add-mappings: false

在 @RestControllerAdvice 中捕获

配置生效后,NoHandlerFoundException 就能被全局异常处理器捕获:

  • 定义一个 @RestControllerAdvice 类,添加对应方法:
@RestControllerAdvice
public class GlobalExceptionHandler {
  @ExceptionHandler(NoHandlerFoundException.class)
  public Result> handle404(NoHandlerFoundException e) {
    return Result.fail("404", "请求地址不存在");
  }
}

其中 Result 是你项目里统一的响应封装类(含 code、msg、data 字段),确保返回的是标准 JSON,而非 HTML 页面。

注意 405 方法不支持的情况

同理,405(Method Not Allowed)也需要额外配置才能被捕获:

  • 在相同配置基础上,加一行:
spring:
  mvc:
    throw-exception-if-no-handler-found: true
    # 同时启用 405 异常抛出
    throw-exception-if-no-handler-found-for-method: true

然后在异常处理器中补充:

@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
public Result> handle405(HttpRequestMethodNotSupportedException e) {
  return Result.fail("405", "不支持的请求方法: " + e.getMethod());
}

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java spring mvc

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2531

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

2026.10.15

0

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习