为什么你写了日志，线上还是定位不了问题？

文章主旨：在生产环境中，异常处理的核心不是抛出异常，而是通过分层设计、统一返回结构和明确的业务异常，实现快速定位问题、止损恢复。

关键要点：

• 生产环境异常需满足“对外可控、对内可查、责任清晰”三大原则。
• 异常必须分层：业务异常（可预期）与系统异常（不可预期）严格区分。
• 异常返回结构应统一，永远不直接暴露给前端，使用ApiResult封装code、message、data。
• 业务异常（BizException）需自定义为运行时异常，包含code和message，用于校验失败、状态不合法等场景。

内容结构：

• 前言：强调生产问题分析的关键在于日志定位，异常设计的目的是快速定位、止损、恢复服务，而非仅仅抛出异常。
• 一、异常在生产环境中的正确定位：提出异常设计的三点目标（对外可控、对内可查、责任清晰），并推荐异常分层（业务异常 vs 系统异常）。
• 二、统一返回结构：异常不等于500：说明异常永远不应直接返回给前端，应使用ApiResult结构（code、message、data），异常场景下data为空。
• 三、业务异常：一定要存在：介绍自定义业务异常BizException（继承RuntimeException），包含code和message，并给出使用场景示例（如金额校验失败）。

文章总结：本文强调生产环境异常设计的实用原则与代码实践，建议开发者将异常视为“可查线索”而非“错误信号”，以提升线上问题的排查效率与系统稳定性。

将代码集体所有权进行到底！

了解更多

热爱技术的小郑

查看原文：为什么你写了日志，线上还是定位不了问题？

文章来源：

热爱技术的小郑

扫码关注公众号