架构图何时有用先画出数据和失败出口架构图不是给方框排队。读者真正想知道的是数据从哪里来在哪一步被判断失败后去哪儿以及谁有权处理它。只有组件名和箭头的图通常看起来很忙实际帮不上排障。一张图只回答一个问题若要解释请求链路就突出入口、依赖和返回若要解释权限就画身份、资源与校验点若要解释部署再画网络边界和运行单元。别试图把部署、时序、数据库表和报警规则塞进同一张图PPT 不是春运。给箭头写上语义区分同步调用、异步消息、数据落盘和人工操作。对关键边界标出输入类型、超时或失败去向遇到权限隔离时明确哪些箭头不允许跨过去。图中的名称最好与代码、日志和配置中的名称一致读图才不会变成翻译工作。画完找一个没参与设计的人拿一条失败请求让他按图走一遍。走不通的地方不一定是读者笨多半是图漏了出口。