软件架构原则不是越多越好:警惕“原则泛滥”的三大陷阱
软件架构原则越多越好?大多数团队都踩过“原则泛滥”的坑
我见过太多团队,刚成立就把SOLID、KISS、YAGNI、微服务设计原则列了满满一屏wiki,代码提交前要对照十几条规范评审,结果一个月过去了,核心业务链路还没跑通。35
软件架构原则本质是前人踩坑总结的经验,目的是降低风险、提升效率。但如果不问场景、不看阶段,把原则当成铁律严格执行,反而会适得其反。37
01架构原则本身没有错,错的是不分场景的机械套用
现在开发者能接触到的架构原则越来越多,从经典的SOLID五大原则,到26条复杂系统架构原则,再到各种大厂的架构规范,很容易让人陷入“多即正确”的误区。43
但你要先想清楚一个问题:这些原则设计的初衷是什么?
关于架构原则的两种典型立场
原则应严格遵循
认为架构原则是经过验证的最佳实践,严格执行能避免后续踩坑
- 长期来看,遵循原则能降低系统维护成本,减少技术债务
- 统一的原则标准能降低团队协作成本,避免各人代码风格差异过大
- 对于核心业务模块,严格遵循原则能大幅降低故障概率
原则需灵活裁剪
认为原则是工具而非目的,应根据场景调整应用强度
- 小型项目、一次性工具完全不需要严格遵循SOLID,否则会增加不必要的复杂度
- 创业团队核心目标是快速验证业务,过度遵循原则会拖慢上线节奏
- 原则之间本身存在冲突(如单一职责vs接口数量膨胀),必须根据场景权衡
这两种立场没有绝对的对错,核心差异在于适用场景。如果你的团队维护的是亿级用户的支付系统,那核心链路必须严格遵循相关原则;但如果是5人小团队做业务验证,先把功能跑通比什么都重要。70
02原则泛滥的三个典型恶果,很多团队都中招了
我见过太多团队,把收集原则、制定规范当成架构师的核心KPI,最后陷入“原则越多、效率越低”的怪圈。最常见的问题有三个。
第一个是决策瘫痪。架构评审时,有人拿单一职责说你这个类职责太多,有人拿YAGNI说你不需要提前做扩展,有人拿开闭原则说你应该做抽象层,吵了一下午也没个结论。本质就是原则太多,任何决策都能找到相反的原则来反驳。40
丘吉尔说过“唯有完美才算数→就是瘫痪”,放在架构设计里同样适用。追求符合所有原则的完美方案,只会导致项目迟迟无法推进。
第二个是过度设计。为了符合开闭原则,明明只有两种支付方式,非要做三层抽象、预留十种扩展点;为了符合单一职责,明明100行代码能搞定的功能,拆成了5个类、十几个接口。最后代码是“好看”了,但是排查问题要跳七八个文件,新人上手成本翻了三倍。39
我之前参与过一个电商项目,早期团队为了“符合微服务原则”,把用户、订单、商品、支付拆成了4个独立服务,结果整个团队只有3个后端,每个人要维护两个服务的迭代、部署、排查问题,苦不堪言。最后花了两周时间合并成单体服务,开发效率直接翻了一倍。44
数据也验证了这一点:过度遵循单一职责会导致服务碎片化,开闭原则的抽象层会引入15%的实例化耗时,迪米特法则会增加30%的接口维护工作量。这些隐性成本,很多团队在套用原则时根本不会计算。47
第三个是协作成本飙升。新人入职要先背几十条架构原则,代码评审时要对照十几条规范检查,需求评估时要先争论符合哪条原则。最后大家的精力都花在“符合原则”上,反而没人关心业务能不能跑通、用户能不能用。41
10人以下的小团队尤其明显。我见过一个5人团队强推前后端分离,前端和后端每天花3个小时联调接口,后来改成前后端一体化架构,用tRPC实现类型全链路同步,联调时间直接归零,需求上线速度提升了60%。67
03合理使用架构原则的三个行动标准,直接就能用
架构设计的核心逻辑永远是“风险驱动,够用就停”。原则是用来降低风险的,当风险降到可接受水平时,就没必要再为了符合原则增加额外投入。37
具体怎么落地?我总结了三个可直接复用的判断标准。
第一个标准:先匹配阶段,再谈原则。不同规模、不同阶段的团队,对架构原则的需求完全不一样。
40人左右的增长期团队,核心目标是边界清晰。这时候需要按业务域拆分服务,明确定义接口契约,可以开始引入SOLID等原则规范核心模块的代码质量,但非核心模块依然保持简单。41
60人以上的成熟团队,核心目标是提效。这时候可以建立架构委员会,梳理完善的架构原则和规范,推动通用能力下沉,用规范降低大规模协作的成本。
第二个标准:建立团队共识的最小原则集。不要把能找到的所有架构原则都列进规范,一个团队的核心原则不要超过5条,超过了就等于没有。
我带团队的时候,早期核心原则只有两条:一是核心业务逻辑必须写单元测试,二是对外接口必须兼容三个版本。其他所有原则都只是参考,代码评审时如果没有明确的风险点,就不要拿原则说事。
你可以试着梳理下你们团队的原则,把那些从来没人遵守、或者遵守了也没什么收益的原则全部删掉。原则越少,大家越容易记住,执行起来也越到位。
第三个标准:用“三个问题”判断是否需要引入原则。每次你想套用某个架构原则时,先问自己三个问题:
- 这个原则能解决当前的真实问题吗?如果只是为了“未来可能出现的问题”,那就不要用,90%的“未来需求”永远都不会来。45
- 团队有能力维护符合这个原则的代码吗?如果团队大部分人都搞不懂抽象层怎么设计,强行推行只会写出四不像的代码。
- 如果业务失败了,这个原则带来的投入还有价值吗?如果答案是没有,那说明你在做不必要的提前投入。
三个问题的答案都是“是”,你再去用对应的原则。
当前文章无评论,是时候发表评论了