一、明确目标与边界关键起点确定核心场景聚焦单一业务流程如“用户支付”而非整个电商系统避免信息过载。例若绘制登录流程仅包含身份验证相关交互排除注册或密码找回分支。定义上下文创建实体字典统一参与者命名如“支付服务”而非“PaymentService”确保所有时序图使用一致术语。绘制上下文图标注直接交互的实体移除间接关联对象如支付流程中省略用户画像模块。二、识别参与实体与排列规则实体选择原则只包含直接交互的实体例如支付流程中保留“用户客户端→API网关→支付服务→数据库”移除日志服务等非核心模块。粒度一致避免混合系统级与模块级实体如微服务架构中统一用服务名而非内部组件。实体排列顺序从左到右按交互触发顺序排列最左发起者如用户/客户端中间中间处理层如网关、服务最右数据层如数据库。交互频繁的实体尽量靠近减少箭头交叉。三、绘制消息流核心步骤消息类型规范消息类型符号使用场景同步消息实线箭头➔阻塞调用如HTTP请求异步消息虚线箭头⤳非阻塞通信如MQ发送返回消息虚线箭头⇠必须与同步消息成对出现自调用消息箭头折返对象内部方法调用消息标注要点关键参数在消息旁注明输入/输出如订单ID202506211234。协议与性能标注协议类型gRPC/HTTP、延迟timeout 500ms。消息序号左侧添加序号如1.1、1.2避免顺序混乱。激活条Focus of Control用矩形条标记对象处理时段明确执行周期DatabasePaymentServiceUserDatabasePaymentServiceUser支付请求扣款成功⚙️四、处理复杂逻辑与异常组合片段应用alt条件分支如登录成功/失败loop循环操作如重试3次par并行处理如同时验证密码和短信码AuthServiceUserAuthServiceUseralt[验证成功][验证失败]loop[3 times]发送验证码返回Token错误提示异常边界标注显式标注超时重试、熔断机制如circuit_breaker。强依赖调用链添加超时提醒如数据库查询标注200ms。️五、优化与工具实践工具推荐代码生成PlantUML/Mermaid适合技术文档支持版本控制。图形化工具Draw.io/Lucidchart拖拽操作适合协作评审。硬件时序WaveDrom用JSON描述信号时序。评审与迭代版本命名文件名含日期和版本如支付时序_20250621_v1.2。团队验证通过协作工具收集反馈检查消息顺序和异常覆盖。六、避坑指南常见问题解决方案消息顺序错乱添加序号 激活条显示处理时段协议混淆HTTP/RPC用实/虚线区分同步/异步标注协议无限循环loop片段明确标注重试次数