技术架构图交付前:怎样检查信息、边界和可读性
交付前先确认图中的对象、箭头和边界能对应到实际接口或配置;画得漂亮不等于信息完整。
先界定问题
用精美架构图讲清复杂技术原理的方法 是否合适,取决于任务约束。先写清目标任务、可能失败的输入或依赖,以及通过条件,别把演示中的顺利路径当成生产能力。
处理与验证
用图说明决策与边界,不只画组件。一张图至少交代数据从哪里来、经过哪些判断、在哪里失败以及谁负责恢复;再让实际接口和日志验证它。
准备覆盖正常请求、空结果、格式错误和依赖超时的样本。每次只调整一个变量,保存配置、样本版本和原始结果;先复现,再判断问题来自数据、配置、实现还是外部依赖。
对比结果应说明环境、并发方式、数据规模、预热和统计口径;缺少这些条件,就不要发布 P95、吞吐或“提升”结论。还要检查异常输入、重试是否放大负载,以及开关和旧路径能否回退。