异常处理关键变量记录指南

异常上下文是程序崩溃瞬间的关键现场快照——包括user_id、order_id、api_path、db_query等可追溯的业务变量与状态，它不是冗余信息，而是将“为什么崩了”从猜谜变成精准定位的核心线索；忽视它，排查就像盲人摸象：日志断链、监控失焦、现场湮灭；而通过带cause构造异常、显式拼接关键字段、避免MDC依赖和无意义包装等实践，能让每一次异常都自带诊断说明书，大幅缩短故障响应时间、降低协作成本，并真正让错误成为系统进化的可靠反馈。

异常上下文到底指什么

就是抛出异常那一瞬间，程序里哪些变量、状态、调用链路是「已知且可追溯」的。不是日志时间戳或进程 ID，而是能直接帮人定位“为什么这里崩了”的那几样东西：user_id、order_id、http_method、api_path、db_query（如果已拼好）、甚至 retry_count。它们共同构成异常发生时不可复现的现场快照。

不放关键变量=让排查变成盲人摸象

常见错误现象：NullPointerException 报在 userService.updateProfile()，但没带 userId；SQLIntegrityConstraintViolationException 出现在插入订单，却看不到 orderNo 或 payAmount。结果是：翻日志要手动关联上下游，查监控得猜时间窗口，重启服务后现场消失。

实操建议：

• 捕获异常后，用 String.format() 或 logger.error("msg", e) 的变体把关键变量塞进 message，例如：logger.error("fail to update profile for user {}, cause: {}", userId, e.getMessage(), e)
• 避免只拼接 e.toString() —— 它不含业务字段，且可能被 logback 截断
• 不要依赖 MDC（Mapped Diagnostic Context）自动注入——它依赖线程上下文，在异步、RPC、线程池场景下极易丢失

Java 中 Throwable 的 fillInStackTrace() 会吞掉上下文

很多人以为 new 一个新异常再 throw 就行，比如：throw new RuntimeException("update failed")。这会丢掉原始堆栈和所有上下文信息。更糟的是，有些框架（如 Spring AOP）会在代理层重新包装异常，进一步擦除原始现场。

实操建议：

• 优先用带 cause 的构造函数：throw new ServiceException("update failed for " + userId, e)
• 如果必须新建异常，至少保留原始 cause 和关键字段，别只留空字符串
• 检查你用的 RPC 框架（如 Dubbo、gRPC）是否默认序列化 Throwable 全字段——很多只传 message 和 stackTrace，suppressed 和自定义字段全丢

Go 的 error wrap 和 fmt.Errorf("%w") 容易漏掉 context

Go 1.13 引入了 error wrapping，但 fmt.Errorf("failed to process %s: %w", key, err) 只保留了 key 字符串，原始 error 里的 userID、traceID 等结构体字段不会自动透出。

实操建议：

• 自定义 error 类型时，显式实现 Error() 方法并拼入上下文字段，例如返回 fmt.Sprintf("user %s: %v", e.userID, e.err)
• 用 errors.As() 提取底层 error 时，记得同时取它的上下文字段，而不是只看顶层 message
• 避免在中间层无意义地 wrap：比如 HTTP handler 里 return fmt.Errorf("handler error: %w", serviceErr)，不如直接返回 serviceErr 并确保它本身已含 context

上下文不是越多越好，而是要在抛出点就决定“谁会看这个异常”——运维看日志要 traceId，开发查问题要 inputParams，DBA 分析慢查询要 sql 和 bindValues。漏一个，就多花十分钟翻三份日志。

今天关于《异常处理关键变量记录指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！