当前位置:首页 > 技术 > 正文内容

Spring MVC全局异常处理与重定向数据传递实践

访客 技术 2026年8月21日 13

异常处理机制解析

Spring MVC框架提供了多层次的异常响应转换策略。当控制器方法抛出异常时,框架会自动将特定异常类型映射为对应的HTTP状态码。若未匹配到预设映射,系统默认返回500服务器错误。关键映射关系如下:

Spring异常与HTTP状态码映射表

开发者可通过@ResponseStatus注解定制业务异常的响应状态。例如定义用户不存在异常:

/**
 * 自定义404异常类型
 * code: HTTP状态码
 * message: 错误描述信息
 */
@ResponseStatus(code = HttpStatus.NOT_FOUND, message = "用户资源不存在")
public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException(String userId) {
        super("ID: " + userId);
    }
}

对于跨控制器的全局异常处理,推荐使用@ControllerAdvice结合@ExceptionHandler。以下实现将捕获所有异常并返回标准化JSON响应:

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler
    @ResponseBody
    public ApiResponse handleAllExceptions(Exception ex) {
        return ApiResponse.error(500, "系统繁忙,请稍后重试");
    }
}

控制器通知优先级问题

在Spring Boot应用中,自定义异常处理器可能因优先级问题失效。启动日志显示:

Detected @ExceptionHandler methods in systemExceptionHandler
Detected @ExceptionHandler methods in customExceptionHandler

当多个异常处理器存在时,框架会优先调用高优先级Bean。通过@Order注解提升自定义处理器优先级:

@ControllerAdvice
@Order(Ordered.HIGHEST_PRECEDENCE)
public class CriticalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    @ResponseBody
    public ApiResponse handleNullPointer(NullPointerException e) {
        return ApiResponse.error(400, "请求参数异常");
    }
}

重定向数据传递方案

当控制器返回redirect:/target时,需特殊处理数据传递。框架提供两种有效方式:

路径参数传递:适用于简单数据类型,通过URI模板携带参数:

@GetMapping("/profile")
public String redirectToProfile(Model model) {
    model.addAttribute("userId", "U1001");
    model.addAttribute("role", "admin");
    return "redirect:/users/{userId}?access={role}";
}

最终生成重定向路径:/users/U1001?access=admin

闪存属性传递:适用于复杂对象,利用RedirectAttributes实现跨请求数据暂存:

@GetMapping("/submit")
public String processForm(RedirectAttributes redirectAttrs) {
    UserProfile profile = new UserProfile("张三", 28);
    redirectAttrs.addFlashAttribute("user", profile);
    redirectAttrs.addAttribute("status", "success");
    return "redirect:/result";
}

@GetMapping("/result")
public String showResult(Model model) {
    // 从模型中获取闪存属性
    boolean hasUser = model.containsAttribute("user"); // 返回true
    return "result-page";
}

该机制底层通过会话存储实现,仅适用于同一应用内的重定向操作。

相关文章

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

linux screen 用法详情 (nohup 的替代方案)

一、screen 是什么?能干嘛?screen 是一个终端复用器,可以:在一个 SSH 会话中开多个“虚拟终端”SSH 断线后,程序仍然在后台运行随时重新连接到原来的会话特别适合:nohup 的替代方案跑脚本 / 爬虫 / 训练模型运维、远程开发二、安装 screen# CentOS / Rocky / Almayum install -y screen# Debian / Ubuntuapt i...

PHPStan 有什么用?怎么用?

PHPStan 是一个 PHP 的静态分析工具,在不运行代码的情况下就能帮你发现潜在问题,比如:传错类型(把 string 传给接受 int 的函数)访问不存在的属性 / 方法null 没处理好永远不会执行到的代码数组 key/值类型不一致返回值不符合声明注释和真实类型不匹配它非常适合:想提升代码质量、减少线上 bug、统一团队风格的人(尤其是中大型项目)。一、PHPStan 有什么用(通俗点说)...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。