0

0

在Java中如何编写易维护的异常处理代码_Java异常规范解析

P粉602998670

P粉602998670

发布时间:2026-02-05 10:59:30

|

277人浏览过

|

来源于php中文网

原创

生产环境禁止e.printStackTrace(),须用SLF4J记录带业务标识的日志;禁用空catch;受检异常仅用于调用方必须恢复的场景;finally中避免抛异常,优先用try-with-resources;异常信息需含可行动上下文并脱敏敏感数据。

在java中如何编写易维护的异常处理代码_java异常规范解析

避免在 catch 块里只写 e.printStackTrace()

这是最常见也最危险的习惯——它把异常信息输出到标准错误流,既没记录上下文,也没触发监控,线上出问题时根本没法定位。生产环境必须用日志框架(如 SLF4J)记录,并带上关键业务标识。

  • logger.error("订单支付失败,orderNo={}", orderNo, e),而非 e.printStackTrace()
  • 不要吞掉异常:空 catch 块或只打日志不抛出/不处理,等于掩盖故障
  • 若决定忽略某类异常(如 InterruptedException 在清理线程时),必须加明确注释说明“为什么可忽略”

区分 RuntimeException 和受检异常的使用场景

Java 强制你处理受检异常(Exception 及其子类,但不包括 RuntimeException),但这不意味着“所有异常都该是受检的”。滥用受检异常会导致大量无意义的 throws 声明和模板式 try-catch,反而降低可读性。

  • 受检异常适合:调用方**必须决策如何恢复**的场景,比如 IOException(文件不存在?重试?降级?)
  • RuntimeException 更适合:程序逻辑错误或不可恢复的意外,如 IllegalArgumentExceptionNullPointerException(应提前校验,而非靠 catch)
  • 自定义异常优先继承 RuntimeException,除非你有强契约要求调用方显式处理

不要在 finally 里执行可能抛异常的操作

finally 的本意是保证资源释放,但如果里面又抛出新异常,会覆盖原始异常,导致根因丢失——这是调试时最让人抓狂的问题之一。

剪小映
剪小映

记录美好智能成片,AI智能视频剪辑

下载
  • 关闭资源用 try-with-resources,它自动抑制(suppressed)后续异常,保留主异常
  • 如果必须手写 finally(如老 JDK),对每个 close 操作单独 try-catch,并记录而非抛出
  • 示例错误写法:finally { outputStream.close(); } —— close() 可能抛 IOException,覆盖前面的业务异常

异常信息要包含“可行动”的上下文,而非仅堆

堆栈告诉你“哪里出错了”,但运维和下游服务需要知道“什么条件下错的”。比如 "HTTP 500 from payment gateway" 远不如 "Payment gateway timeout after 30s, requestID=abc123, amount=¥299.00" 有用。

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

  • 构造异常时传入组合字符串,而非拼接后丢给 getMessage()
  • 避免泛化消息如 "操作失败",换成 "无法更新用户邮箱:邮箱已被其他账号占用(email=john@example.com)"
  • 敏感信息(密码、token、身份证号)必须脱敏,日志中禁止明文出现
真正难的不是捕获异常,而是判断这个异常是否属于当前方法的职责边界——该转成更上层能理解的业务异常?该静默容忍?还是该立即中断流程?这些决策点藏在 if 分支里,不在 try 块中。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
504 gateway timeout怎么解决
504 gateway timeout怎么解决

504 gateway timeout的解决办法:1、检查服务器负载;2、优化查询和代码;3、增加超时限制;4、检查代理服务器;5、检查网络连接;6、使用负载均衡;7、监控和日志;8、故障排除;9、增加缓存;10、分析请求。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

596

2023.11.27

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

224

2023.12.07

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

794

2023.08.22

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

794

2023.08.22

scripterror怎么解决
scripterror怎么解决

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

309

2023.10.18

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

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

317

2023.10.25

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6296

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

827

2023.09.14

java连接字符串方法汇总
java连接字符串方法汇总

本专题整合了java连接字符串教程合集,阅读专题下面的文章了解更多详细操作。

7

2026.02.05

热门下载

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

精品课程

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

共23课时 | 3.3万人学习

C# 教程
C# 教程

共94课时 | 8.6万人学习

Java 教程
Java 教程

共578课时 | 58万人学习

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

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