⭐⭐⭐⭐⭐ 5星
系统架构
工程实践
7 More Common Mistakes in Architecture Diagrams
系统架构图绘制的常见错误
摘要
系统架构图是记录复杂系统的重要工具，但常见的错误会导致混淆、误解和挫折。本文介绍7个常见的架构图错误及解决方案。
7个常见错误
Mistake #1: Not including resource names
资源只用类型标签而没有名字。如只用"EC2"、"S3"等类型名，而没有具体的资源名称如"Orders Table"、"Results Bucket"。
Mistake #2: Unconnected resources
孤立资源 - 某些资源与其他资源没有连接。如Route 53被放在图中但与其他资源没有关系，这样就失去了画图的目的。
Mistake #3: Making a "master" diagram
试图在一个图中展示所有内容。包含运行时依赖、DNS配置、CDN配置、源代码、部署依赖等，导致信息过载。
Mistake #4: Conveyor belt syndrome
过度简化导致误导。把系统画成流水线，数据从一个资源整齐地流到下一个，而实际系统有大量的往返交互。
Mistake #5: Meaningless animations
无意义的动画。只为营销目的存在，吸引注意力但不提供技术价值，动画箭头完全冗余。
Mistake #6: Fan traps
Fan traps发生在基于事件的系统图中，边缘资源之间的具体通信在共享消息代理中丢失。
核心洞察: "好的架构图应该讲述一个连贯的故事，而不是试图展示一切"
解决方案
多个Perspectives
将"master"图拆分成多个视角：运行时依赖、DNS配置、部署流程等。每个视角讲述一个连贯的故事而不相互干扰。
使用Sequence Diagrams
对于需要展示详细交互的系统，使用序列图(UML)来展示资源之间的详细往返交互。
明确资源关系
确保每个资源都与图中其他资源有某种方式的连接，表达它们之间的关系。
同时标注类型和名称
在空间允许的情况下，让观众知道资源的名称和类型。可以简单地在资源名称后加类型后缀。