个人开发者的日志习惯：给每个接口补一行可检索的请求摘要

我在做个人项目时最怕的一件事，是线上出了问题却翻不到当时发生了什么。日志很多，但真正想查的时候，只剩一堆堆栈，看不出是谁、在什么条件下触发的。后来我给自己定了一条很小的规矩：每个对外接口在入口处补一行请求摘要，只记和定位有关的信息，不记正文。一行里固定包含请求编号、接口名、调用方、耗时、结果码这五项，字段顺序不变，方便以后用一条命令过滤。请求编号在网关生成，一路透传到下游，这样跨服务也能串起来。调用方只记应用名，不记用户标识，避免把个人数据写进日志。耗时用毫秒整数，结果码用统一的枚举，成功和失败都记，失败时再追加一句原因的摘要，不超过三十个字。这行摘要我放在中间件里统一打印，业务代码不用关心。上线后排查一次超时，我只用请求编号就把入口、下游调用和最终返回对上了，比从前翻整段堆栈快很多。这个习惯几乎没有额外成本，对个人开发者来说，比上一套完整的链路追踪平台更轻，也足够应付日常的问题定位。