有个现象挺常见。一个 PR 改了三行,评审人说没问题。三天后,服务开始绕开领域层,直接查对方数据库。没人违规?每行代码都合规。但架构已经歪了。
代码评审中的架构一致性检查,大概就卡在这。你看的是 diff,漏的是依赖方向。
评审桌上最容易被放过的那类改动
小改动最危险。加一个 import。注入一个 mapper。监听一个事件。把两个字段拼进 DTO。局部看,都合理。放到系统里,未必。
比如订单服务要查库存。同步调用写起来最快。评审时,函数名清楚,参数清楚,测试也过。可它把订单对库存的依赖变硬了。库存服务一抖,订单就跟着抖。如果业务上本来只需要最终一致性,这个同步调用就是架构漂移。
麻烦在于,这类问题不会报编译错误。ArchUnit 可能能查,但前提是规则先写好。更多时候,评审人靠记忆。今天记得,明天换个人,就放过去了。
架构一致性检查,不是看命名风格,也不是看目录整齐。它盯的是依赖方向、数据所有权、边界穿越、同步异步选择、事务范围、失败传播。说白了,就是这次改动有没有让某个模块承担它不该承担的责任。
数据库直连是重灾区。A 服务读 B 服务的表,开始时只读一个字段。后来加 join。再后来,B 服务改表,A 服务崩。代码评审里,SQL 写得漂亮,仍然可能把两个服务的发布节奏绑死。
还有共享库。工具包、通用模型、内部 SDK。加一个类很容易。问题是,这个类属于谁。它依赖了谁。如果共享库反向依赖上层模块,循环依赖就来了。构建变慢只是小代价。真正麻烦的是,没人敢改。

架构一致性不是画在墙上的图
很多团队有架构图。画在 Confluence 里。颜色好看,箭头清楚。评审的时候,没人打开。不怪评审人。图是三个月前的,代码是今天的。
要让架构一致性可检查,得把原则变成约束。依赖规则。包结构。模块边界。接口契约。事件 schema。数据表 owner。能写成静态检查的,尽量写。不能写的,写成评审问题。
比如一条硬规则:领域层不能依赖基础设施层。用依赖注入倒置。这个适合工具检查。一条软规则:跨服务调用要说明理由。这个适合人看。两者混在一起,评审才不会变成背诵口号。
取舍也在这里。规则太松,架构图就是装饰。规则太死,合理演进会被卡住。比如一个新功能确实需要跨边界读数据。如果直接禁止,团队会绕路,最后绕得更乱。更好的做法是,要求新增跨边界访问必须留下 ADR,说明为什么现有接口不够。评审时看 ADR,不看谁嗓门大。
ADR 不用长。一页就够。背景,决策,后果。谁批的,什么时候复审。代码评审里,如果 diff 违反既有边界,评审意见可以引用 ADR 编号。这样讨论的是规则,不是资历。

把检查变成可执行的摩擦

评审清单如果写成“是否符合架构”,等于没写。太虚。有效的问题都很具体。
这次改动引入了哪个新依赖?被依赖模块的 owner 知道吗?有没有新增对别的服务数据库的访问?事务跨了几个服务?失败重试会不会重复扣款?事件消费者是否幂等?接口变更是破坏性的还是兼容的?配置开关默认值是什么?日志和 trace 能不能串起来?
这些问题不需要全问。看改动类型。改接口,问契约。改数据访问,问 owner。改异步流程,问幂等和补偿。改共享库,问依赖方向。
工具能帮上忙。依赖检查、契约测试、schema 兼容检查、CODEOWNERS。把这些挂到 CI 上。红灯亮了,评审人就不用靠肉眼找 import。代价是维护规则。误报要处理。规则多了,也会烦。那就保留几条硬规则,别搞成大杂烩。
我见过一种做法,效果还行。架构 owner 不参加所有评审。只在 diff 触碰边界时被拉进来。CODEOWNERS 自动加人。这样日常小改动不拖。真正的架构变更,有人把关。
评审意见也要落到具体行。别写“不符合架构”。写“这里让库存服务反向依赖订单服务,形成环,建议改成事件”。前者是判决,后者是修改路径。人更愿意改。
还有一点,别把架构一致性检查搞成审批。它更像刹车灯。不踩油门时也要亮。代码评审中的架构一致性检查,重点不是抓住谁,而是让边界在合并前被看见。
上线后才看见,代价通常不是多写几行代码。是回滚、加班、补丁,和下一次没人再信架构图。
所以,下一次打开 PR,别只看 diff 绿不绿。看一眼它把依赖箭头指向了哪里。很多时候,问题就藏在那。