非受检异常处理的最佳实践与错误捕获

舞姬之光

舞姬之光

2026-08-02

452人浏览

原创

非受检异常应通过预防、精准响应和结构化表达治理,而非泛化捕获;优先校验输入与状态,必要时用自定义业务异常替代通用runtimeexception,并辅以日志监控与告警。

非受检异常处理的最佳实践与错误捕获

非受检异常(即 RuntimeException 及其子类)不该靠“捕获”来兜底,而应靠“预防+精准响应+结构化表达”来治理。它们不是运行时意外,而是代码逻辑漏洞的信号灯。

不捕获,先拦截:用校验代替 catch

空指针、参数非法、下标越界等,90% 以上源于输入或状态未校验。与其等它抛出再 try-catch,不如在入口主动拦截:

  • Objects.requireNonNull(obj, "user 不能为空") 替代手写 if (obj == null) throw new NullPointerException()
  • 业务参数用 Assert.isTrue(amount.compareTo(BigDecimal.ZERO) > 0, "金额必须大于 0") 提前失败
  • 集合操作前调用 list.isEmpty()list.size() > index,避免 IndexOutOfBoundsException
  • 字符串转数字前,先用 StringUtils.isNumeric(str) 或正则预判,防止 NumberFormatException

真要捕获?只在有明确动作时

绝大多数业务方法里,catch (RuntimeException e) 是反模式。真正合理捕获的场景极少且具体:

DuMate
DuMate

百度推出的面向个人及团队的桌面级AI智能体

下载
  • 调用不可控第三方 SDK,它内部抛 IllegalArgumentException 且文档说明该情况可安全忽略或重试
  • 在消息消费、定时任务等异步流程中,为防单条失败导致整个线程中断,做一层轻量级兜底并记录日志
  • 全局统一入口(如 Spring 的 @RestControllerAdvice),用于格式化返回、脱敏打点、触发告警——这不是“处理异常”,而是“响应异常”

用自定义业务异常替代通用 RuntimeException

余额不足、重复提交、权限拒绝……这些不是 bug,是业务规则的自然结果。应定义语义清晰的非受检异常:

  • 继承 RuntimeException,不强制上层声明,保持接口简洁
  • 命名直白,如 InsufficientBalanceExceptionForbiddenAccessException
  • 构造时传入错误码(如 "BALANCE_001")、带上下文的消息("用户 U123 余额不足,需 100.00,当前仅 12.50")、以及原始异常(cause)便于追溯
  • 配合全局处理器,统一转换为标准 JSON 错误响应,前端可直接解析 errorCode 做差异化提示

日志与监控是底线保障

非受检异常虽不强制捕获,但一旦发生,必须可查、可溯、可预警:

  • 全局异常处理器中,记录 ERROR 级日志,包含异常类型、完整堆栈、关键业务 ID 和脱敏后的输入参数
  • 对高频出现的同一异常(如某接口每分钟 NPE 超 5 次),配置实时告警,指向具体代码行和最近一次变更
  • 将异常统计接入可观测平台,按异常类型、接口路径、环境维度聚合分析,识别稳定性薄弱点

相关文章

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

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

下载

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

相关专题

更多
墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

1

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

1

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

3

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

2

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

0

10

火山引擎对象存储使用教程
火山引擎对象存储使用教程

火山引擎对象存储适合用于网站图片、视频文件、备份数据、静态资源和应用附件管理。本专题整理TOS控制台入口、存储桶创建、地域选择、权限设置、文件上传、访问链接生成、CDN加速、费用查看和常见上传或访问失败问题,帮助用户快速掌握对象存储基础操作。

2026.08.04

1

10

火山引擎云服务器使用教程
火山引擎云服务器使用教程

火山引擎云服务器使用教程适合第一次购买、部署和管理云服务器的用户参考。本专题整理控制台入口、实例创建、地域和配置选择、系统镜像设置、安全组放行、远程连接、网站部署、续费计费和常见连接失败问题,帮助用户快速完成云服务器基础使用流程。

2026.08.04

3

10

火山引擎API Key绑定大模型教程
火山引擎API Key绑定大模型教程

火山引擎API Key怎么绑定大模型适合需要在火山方舟、应用后台、脚本工具或AI编程软件中调用模型的开发者参考。本专题整理控制台服务开通、API Key创建、模型权限检查、模型ID选择、Base URL填写、调用测试和鉴权失败排查,帮助用户完成从密钥到模型调用的配置流程。

2026.08.04

2

10

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.4万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 131.8万人学习