讲师中心 微信公众号
AI工具推荐 视频效率加速

Java如何统一处理异常_Java全局异常处理机制搭建指南

云芳小哥_8983

云芳小哥_8983

发布时间:2025-12-08 19:31:26

|

602人浏览过

|

来源于php中文网

原创

Java统一异常处理核心是@ControllerAdvice配合@ExceptionHandler,结合统一响应格式Result<T>和分级日志记录,实现异常拦截、分类处理与友好返回。

java如何统一处理异常_java全局异常处理机制搭建指南

Java中统一处理异常的核心是用@ControllerAdvice配合@ExceptionHandler,再结合统一响应格式和日志记录,让所有控制器的运行时异常都能被拦截、分类、友好返回,避免堆栈暴露给前端。

定义全局异常处理器类

新建一个类,加上@ControllerAdvice注解,它会自动作用于所有@Controller(包括@RestController):

  • 类上加@ControllerAdvice,可指定包路径(如basePackages = "com.example.controller")缩小生效范围
  • 方法上用@ExceptionHandler声明能捕获的异常类型,支持多个异常类,如@ExceptionHandler({NullPointerException.class, IllegalArgumentException.class})
  • 方法参数可直接写异常对象、HttpServletRequest、HttpServletResponse等,Spring会自动注入

设计统一响应结构

避免每个接口返回Map或Object,建议封装一个标准响应体,比如:

  • Result<T>:含code(如200成功、500系统异常、400参数错误)、msg(提示语)、data(业务数据)
  • 异常处理器里不再return new ModelAndView,而是return Result.fail("操作失败", e.getMessage())
  • 前端统一判断code,无需解析不同字段,也便于后续做国际化或错误码映射

分层捕获与日志记录

不是所有异常都该被全局处理器“吞掉”,要区分场景:

Comprehensive Three.js 3D graphics reference
Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

立即学习“Java免费学习笔记(深入)”;

  • 业务异常(如UserNotExistException)——建议自定义异常并主动throw,由@ExceptionHandler精准捕获,返回400或特定code
  • 系统异常(如NullPointerException、SQLException)——兜底捕获Exception,记录ERROR日志(含堆栈),返回500 + 友好提示(如“服务暂时不可用”)
  • 使用log.error("全局异常捕获", e),确保堆栈完整入库,方便排查

补充:WebMvcConfigurer与异常页面(可选)

如果项目还用JSP/Thymeleaf渲染页面,可额外配置:

  • 实现WebMvcConfigurer,重写configureHandlerExceptionResolvers(),添加SimpleMappingExceptionResolver
  • 为不同异常映射到不同错误页(如404.html、500.html),但REST API项目通常不需要
  • 注意:@ControllerAdvice优先级高于SimpleMappingExceptionResolver,两者不冲突,前者更灵活

基本上就这些。不复杂但容易忽略的是日志记录粒度和响应code的合理性——别让500满天飞,也别把业务错误全塞进200里返回错误信息。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

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

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

2251

2025.08.06

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

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

437

2026.01.26

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

909

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2480

2023.10.25

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3068

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

4389

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3689

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

386

2026.01.19

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn