0

0

Java自定义异常类的实现与应用

P粉602998670

P粉602998670

发布时间:2026-01-10 16:30:02

|

531人浏览过

|

来源于php中文网

原创

应继承exception或runtimeexception,关键看是否需强制捕获:前者用于预期可恢复的业务异常,后者用于程序逻辑错误;避免继承throwable,构造器须显式调用super,并禁用业务字段与耗时操作。

java自定义异常类的实现与应用

继承 Exception 还是 RuntimeException?关键看是否强制捕获

Java 自定义异常类的第一步,是决定它属于「检查型异常(checked)」还是「非检查型异常(unchecked)」。这直接决定调用方是否必须用 try-catch 或声明 throws

  • Exception 及其子类 → 检查型异常:编译器强制处理,适合业务中**预期可能出错且调用方应主动应对**的场景(如文件不存在、参数格式非法但可重试)
  • RuntimeException 及其子类 → 非检查型异常:无需强制捕获,适合**程序逻辑错误或不可恢复的异常状态**(如用户 ID 为空、状态机非法跳转)
  • 别直接继承 Throwable —— 会绕过 Java 异常分类机制,导致行为不可预测

super(message)super(message, cause) 的调用时机

自定义异常类通常只需覆盖构造函数,把消息和/或原始异常传递给父类。不显式调用 super(...) 会导致丢失堆或上下文信息。

public class InsufficientBalanceException extends Exception {
    public InsufficientBalanceException(String message) {
        super(message); // 必须,否则 message 不生效
    }

    public InsufficientBalanceException(String message, Throwable cause) {
        super(message, cause); // 链式异常的关键,保留原始异常堆栈
    }
}
  • 只要重写了构造函数,就必须显式调用父类对应构造器
  • 如果业务需要包装底层异常(如 DAO 层抛出 SQLException,Service 层转为业务异常),务必用带 cause 的构造器
  • 避免在构造函数里做耗时操作(如日志打印、远程调用),异常实例化应轻量

为什么不要在异常类里加业务字段或方法?

异常对象本质是“错误信号”,不是数据载体。往里面塞 userIdorderId 等字段,看似方便取值,实则破坏语义且引发隐患:

成新网络商城购物系统
成新网络商城购物系统

使用模板与程序分离的方式构建,依靠专门设计的数据库操作类实现数据库存取,具有专有错误处理模块,通过 Email 实时报告数据库错误,除具有满足购物需要的全部功能外,成新商城购物系统还对购物系统体系做了丰富的扩展,全新设计的搜索功能,自定义成新商城购物系统代码功能代码已经全面优化,杜绝SQL注入漏洞前台测试用户名:admin密码:admin888后台管理员名:admin密码:admin888

下载
  • 序列化兼容性风险:字段增减会影响反序列化,尤其在分布式 RPC 场景下
  • 违反单一职责:异常该描述“出了什么错”,不该承担“携带上下文数据”的职责
  • 掩盖真正问题:调用方可能依赖这些字段做逻辑分支,把错误处理退化成条件判断
  • 正确做法:用日志记录上下文(如 SLF4J 的 logger.error("转账失败,用户ID: {}, 订单ID: {}", userId, orderId, ex)),异常本身保持精简

Spring 中如何统一捕获并转换自定义异常?

在 Spring MVC 或 Spring Boot 项目里,不建议每个 Controller 都写重复的 try-catch。用 @ControllerAdvice + @ExceptionHandler 统一处理更可靠:

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

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(InsufficientBalanceException.class)
    @ResponseBody
    public ResponseEntity<ApiResponse> handleInsufficientBalance(
            InsufficientBalanceException ex) {
        return ResponseEntity.status(400)
                .body(ApiResponse.error("余额不足", ex.getMessage()));
    }

    @ExceptionHandler(RuntimeException.class)
    @ResponseBody
    public ResponseEntity<ApiResponse> handleUnexpected(RuntimeException ex) {
        // 记录完整堆栈,但对前端只返回泛化提示
        log.error("未预期异常", ex);
        return ResponseEntity.status(500)
                .body(ApiResponse.error("系统繁忙,请稍后重试"));
    }
}
  • 确保 @ControllerAdvice 类被 Spring 扫描到(通常放在主启动类同包或子包)
  • 异常处理器顺序很重要:更具体的异常类型(如 InsufficientBalanceException)要放在更通用的(如 Exception)之前
  • 别在 @ExceptionHandler 方法里再抛异常 —— 会触发默认错误页或 500,破坏统一响应结构
实际用起来最易忽略的是异常类型的传播粒度:同一个业务域内,宁可多定义几个语义清晰的异常类(如 InvalidOrderStatusExceptionConcurrentUpdateException),也不要靠一个 BusinessException 加 error code 去模拟所有情况 —— 那会让错误处理逻辑越来越难维护。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

156

2025.08.06

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

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

88

2026.01.26

spring boot框架优点
spring boot框架优点

spring boot框架的优点有简化配置、快速开发、内嵌服务器、微服务支持、自动化测试和生态系统支持。本专题为大家提供spring boot相关的文章、下载、课程内容,供大家免费下载体验。

139

2023.09.05

spring框架有哪些
spring框架有哪些

spring框架有Spring Core、Spring MVC、Spring Data、Spring Security、Spring AOP和Spring Boot。详细介绍:1、Spring Core,通过将对象的创建和依赖关系的管理交给容器来实现,从而降低了组件之间的耦合度;2、Spring MVC,提供基于模型-视图-控制器的架构,用于开发灵活和可扩展的Web应用程序等。

408

2023.10.12

Java Spring Boot开发
Java Spring Boot开发

本专题围绕 Java 主流开发框架 Spring Boot 展开,系统讲解依赖注入、配置管理、数据访问、RESTful API、微服务架构与安全认证等核心知识,并通过电商平台、博客系统与企业管理系统等项目实战,帮助学员掌握使用 Spring Boot 快速开发高效、稳定的企业级应用。

73

2025.08.19

Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性
Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性

Spring Boot 是一个基于 Spring 框架的 Java 开发框架,它通过 约定优于配置的原则,大幅简化了 Spring 应用的初始搭建、配置和开发过程,让开发者可以快速构建独立的、生产级别的 Spring 应用,无需繁琐的样板配置,通常集成嵌入式服务器(如 Tomcat),提供“开箱即用”的体验,是构建微服务和 Web 应用的流行工具。

147

2025.12.22

Java Spring Boot 微服务实战
Java Spring Boot 微服务实战

本专题深入讲解 Java Spring Boot 在微服务架构中的应用,内容涵盖服务注册与发现、REST API开发、配置中心、负载均衡、熔断与限流、日志与监控。通过实际项目案例(如电商订单系统),帮助开发者掌握 从单体应用迁移到高可用微服务系统的完整流程与实战能力。

271

2025.12.24

Spring Boot企业级开发与MyBatis Plus实战
Spring Boot企业级开发与MyBatis Plus实战

本专题面向 Java 后端开发者,系统讲解如何基于 Spring Boot 与 MyBatis Plus 构建高效、规范的企业级应用。内容涵盖项目架构设计、数据访问层封装、通用 CRUD 实现、分页与条件查询、代码生成器以及常见性能优化方案。通过完整实战案例,帮助开发者提升后端开发效率,减少重复代码,快速交付稳定可维护的业务系统。

32

2026.02.11

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.3万人学习

C# 教程
C# 教程

共94课时 | 11.1万人学习

Java 教程
Java 教程

共578课时 | 80.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号