必要复杂度与意外复杂度
Fred Brooks在《没有银弹》中区分了两类复杂度:必要复杂度是问题本身固有的、无法从定义中移除 的部分(写Web服务器必然要处理如何快速响应请求本身);意外复杂度是解决问题的具体手段带来的 额外负担(如为绕开某语言GC停顿而引入的复杂调度逻辑)。SRE团队应主动消灭意外复杂度:一旦 发现有人正在给自己负责的系统引入意外复杂度,应及时提出抗议。
主题对照
比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。
Fred Brooks在《没有银弹》中区分了两类复杂度:必要复杂度是问题本身固有的、无法从定义中移除 的部分(写Web服务器必然要处理如何快速响应请求本身);意外复杂度是解决问题的具体手段带来的 额外负担(如为绕开某语言GC停顿而引入的复杂调度逻辑)。SRE团队应主动消灭意外复杂度:一旦 发现有人正在给自己负责的系统引入意外复杂度,应及时提出抗议。
面对要删除的旧代码,”注释掉”“留个功能开关以防以后要用”是常见但糟糕的处理方式:版本控制系统 能轻易撤销任何删除,大段注释代码只会在文件演进中造成阅读干扰;挂着未启用功能开关的代码更 危险,它像一颗定时炸弹,可能在不被预期的时刻意外触发——正如Knight Capital因遗留旧交易逻辑 代码被意外激活而蒙受重大损失。系统要保障7×24可用,每一行代码都是需要被验证存在理由的负担, 该删就彻底删。
完美的设计不是无法再添加什么,而是无法再删去什么——这个标准同样适用于API设计:暴露给使用者 的方法和参数越少,接口越容易理解,维护者也能把更多精力投入到把这些少数方法做到极致完善。 有意识地不解决某些边缘问题、把API范围收窄,反而能让核心问题解决得更彻底。一个很小很简单的 API通常不是能力不足,而是设计者对问题本质有更深刻理解的标志。
面对团队完全没有经验的复杂问题(如线性规划求解),与其等彻底理解后再动手,不如先搭一个用简单 启发式规则拼凑的”傻瓜版”方案——它给不出最优解,却能让团队对最终产品该长什么样有真实直觉。 关键工程手法是提前把这个简化方案的接口和系统其余部分解耦,让它未来能被更聪明的实现直接替换, 而不影响其他组件。面对需求本身不确定的领域,同样应把易变部分设计得更抽象、更模块化,用统一 接口封装细节。
数据表示应优先保存当前契约需要的信息,谨慎为假想功能预留结构。为了未来可能的断开连接而保存直接连接,会引入额外测试、文档和维护成本。发散:YAGNI不是拒绝扩展,而是拒绝无证据的复杂度。
通用框架适合共享相同本质结构的问题;一旦目标属性依赖直接连接、路径或更复杂状态,强行塞进原框架会比重写更麻烦。发散:好复用要敢于说“不支持”。
技术债是未来每次新增功能要额外支付的修改成本。赶工时把线缆缠在一起,短期能交付,长期会让任何新增都先变成整理旧结构。发散:架构治理的目标不是消灭变化,而是让变化只触及该触及的位置。
简单数据维护可用CRUD完成,复杂业务的关键在规则、约束和状态变化。DDD有助于金融、物流、资源流等场景表达完整性要求,但是否采用应比较规则复杂度与建模成本;它不会仅靠划分聚合就自动保证并发或跨服务一致性。只展示框架用法的演示通常不需要全套DDD,简单功能也可借鉴清楚语言与边界。
传统数据库扩展常把写入、索引、队列、从库和修复逻辑缠在一起;每次增量更新都把历史状态改写一遍,错误也会被写进核心数据。大数据系统要先降低状态可变性,再谈扩展,否则机器越多,复杂性也越多。
让使用者面对清楚接口,通常需要设计者主动识别和处理复杂性。SHE分别指压缩体量、隐藏非必要细节、赋予品质感;它们是设计启发,不等于把信息一律删掉。书中用熵减比喻简化投入,不能把热力学第二定律直接推广为一切开放系统必然变乱。
当可选项超出任务需要时,使用者要承担额外判断和学习成本。清楚的默认路径与必要扩展可以减少负担,但仍要让真实差异得到表达。书中QQ与微信是当时产品对比,不足以单独证明某个功能的有无决定产品成败,也不意味着越少选择总是越好。
领域专用语言把特定问题域的规则变成容易辨认的表达。Java也可以借连贯接口形成内部DSL,不必先发明外部脚本;极简状态机用事件、条件和动作显性表达流转。选择语法时应比较阅读者、配置需求和实现成本,并非一律用DSL替换通用代码。
去掉执行器内部的业务初始状态和当前状态,可以让调用者传入源状态、接收目标状态,减少实例间的状态管理。这是[[简化逆向做功]]的一种取舍,不等于对象完全没有字段:书中仍有状态规则映射、条件和动作。安全复用要求构建完成后规则稳定、共享依赖及回调安全,性能提升也需要实际测量,而不是由无状态名称直接保证。
业务应用可能因为个人习惯不一致、规则散落、不合理层次和差异逻辑无处安放而难以理解和修改。诊断要定位哪类变化无法被局部吸收,而非只数代码行。书中批评的是缺乏封装的过程堆叠,不能由此推出过程式编程必然复杂或面向对象必然简单。
命名、分包和依赖规则帮助团队根据职责定位改动,减少每次从头搜索的认知成本。规范必须一致执行,也要删除没有帮助的约束。书中以线性查找与散列查找作比喻,并没有测得架构能把任意代码定位严格从O(n)变为O(1)。关联:[[契约约束自由]]
软件长期运行时必然变化,变化会把维护成本推到总成本中心。维护成本又随系统复杂性升高而放大,所以设计的核心目标不是炫技或追新,而是让系统简单清晰、易于修改。发散:评审架构方案时,应先问它五年后是否更便宜维护,再问它现在是否显得先进。
程序面对的是抽象且庞大的复杂性,普通人不可能长期理解一团无组织的代码。编程的核心劳动是把复杂问题组织成可理解的简单部分,让后续开发者无需掌握全部细节也能继续工作。发散:模块边界的好坏,最终要看它是否减少了别人一次性要装进脑子的东西。
把代码写到”能跑”只证明机器接受了指令,不代表复杂性被化解。差设计会把问题交给后来者,使每次新增功能都叠加理解负担。发散:代码评审不应只验证行为正确,还要检查新代码是否降低了下一位维护者的认知成本,呼应[[编程是化繁为简]]。
简单不是代码少、技术旧或实现粗糙,而是让合适的读者更容易理解系统。必要的大段代码、先进技术和注释都可能服务于简单性,前提是它们降低整体理解难度。发散:判断方案是否简单,要站在维护者视角,而不是只数文件、行数或框架数量。
不必要的功能和实现会增加测试、文档、理解与维护成本。先确认真实需求,再考虑已有能力或更简单方案,可以让代码库保留更少负担。没有代码只适用于无需自行实现或无需保留的部分;不能以精简为由删除必要行为、边界处理和保障。
维护精简代码库需要持续识别无用功能、重复与不必要耦合。独立子项目或通用工具只有在实际减少负担时才有意义,不能靠新增目录或删必要处理来追求表面小。
熟悉库提供的能力,可以把代码直接写成任务中的操作,减少手工索引、格式转换和重复实现。先描述需要做什么,再寻找语义相符的已有接口,往往比先写低层步骤更清楚。仍须核对版本、输入结构、失败行为和适用范围,不能因名字相似就假定能力完全匹配。
可定期浏览函数、模块和类型目录,建立有哪些能力可查的线索,而不强求背下API。决定复用时仍要核对细节,例如集合去重与保持原顺序去重不是同一个契约。
新增函数有命名、接口和阅读跳转成本。若拆出的步骤过小、缺少独立概念或没有实际复用需求,读者可能要频繁来回才能理解一件事,反而更难读。抽取应带来清楚的职责、测试或复用收益,超过其间接成本;不机械追求函数越多越短。
纵向分层与横向拆分组件,可以把实现细节封装起来,为使用者提供较简单的接口。关键是决定功能放在哪一层、组件如何交互,避免重复、缺失和不必要的跨层依赖。复杂功能常由内部实现承担,并不意味着接口越简单、系统总复杂度就必然越高;应分别评价使用难度、实现成本和维护成本。
简单方案应满足真实需求,并让结构容易理解和修改;省掉必要能力只是简陋。模式、抽象和复杂技术需要具体理由,不能拿数量证明设计质量。过度压缩或强求优雅也可能损害沟通;当继续精炼已无实质收益时,应转向更有价值的工作。
Node.js 核心库只保留最小功能集合,其余交给核心之外的用户模块生态。这样社区可以在用户空间快速试验和迭代多种方案,而不必等待严格受控、演进缓慢的核心。核心越小越好维护,也把创新压力分散给生态,但代价是同一问题常有多个竞争方案,选型成本落到使用者身上。
Gabriel 的“Worse is Better”主张设计必须简单,实现又要比接口更简单。Node.js 继承了这种取向:先做复杂度合理、能尽快起作用的方案,胜过耗费大量代码追求完美。书中很多经典模式(如单例、装饰器)都会给出平凡、并不万无一失的实现,这是有意的取舍,不是疏忽。
“面向接口编程”的价值在于能在不改调用方的前提下切换实现;若一个接口从一开始就只有、也预期只有一个实现类,就得不到多态收益,只多一层跳转和维护成本。书中秒杀案例因此删掉了服务层的单实现类接口。是否提取接口,要看将来是否真的可能替换实现,而不是“每个服务都该有接口”。原则要检验场景,本身不是目的。
写请求要不要等批量落库完成再返回?同步能让用户立刻看到数据,但要处理一串问题:等多久、超时怎么办、失败是否重试、线程堵到什么时候。异步直接返回“提交成功”,这些问题基本不用考虑,复杂度低得多;体验上可让完成页定时查询落库状态,多数用户感觉不到延迟。只要能接受短暂延迟,异步更划算。
追求分布式、高可用的系统,可能因为节点协调、数据一致性等新增复杂度而更容易出问题、更难排查。书中单机的 Bifrost 上线后没有宕过机,反而多节点负载均衡的服务常出问题;作者也遇到过两次“高可用并不高可用”。所以他们尝试了单机中间件,配上到位的监控告警。这不是否定高可用,而是提醒:高可用的复杂度也要计入故障概率。
BFF 层里有些接口只是原样转发后台服务,看起来多余。团队讨论过去掉它们:让网关绕过 API 层直接调后台,会破坏分层,很快被否决;在 API 层加拦截器,找不到映射就自动转发后台,会增加隐式行为、出问题难排查,收益却只是少几段代码,最终也没采用。为消除少量看似累赘的代码而引入例外或隐式机制,往往得不偿失。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
领域建模类
书籍类型:经典原理
清单覆盖 7/7
405 张卡片
来源书籍
系统架构类
书籍类型:未标注
类别清单尚未核对
384 张卡片
来源书籍
书籍类型:经典原理
290 张卡片
来源书籍
JavaScript运行时与服务端工程类
书籍类型:工程实践
清单覆盖 5/6
174 张卡片
来源书籍
CI/CD 与 DevOps 实践类
书籍类型:经典原理
清单覆盖 6/6
381 张卡片
来源书籍
书籍类型:经典原理
312 张卡片
来源书籍
框架类
书籍类型:工程实践
清单覆盖 8/8
42 张卡片
来源书籍
系统架构类
书籍类型:未标注
清单覆盖 6/6
92 张卡片
来源书籍
系统架构类
书籍类型:经典原理
清单覆盖 3/6
177 张卡片
来源书籍
代码可读性与重构类
书籍类型:经典原理
清单覆盖 7/7
109 张卡片
来源书籍
高可用与云架构风险管理类
书籍类型:工程实践
清单覆盖 7/7
60 张卡片
来源书籍
领域建模类
书籍类型:经典原理
类别清单尚未核对
264 张卡片
来源书籍
分布式系统类
书籍类型:经典原理
类别清单尚未核对
173 张卡片
来源书籍
书籍类型:未标注
389 张卡片
来源书籍
软件架构方法论类
书籍类型:经典原理
类别清单尚未核对
127 张卡片
来源书籍
书籍类型:未标注
71 张卡片
来源书籍
软件设计与复杂性管理类
书籍类型:经典原理
清单覆盖 5/6
297 张卡片
来源书籍
软件设计与复杂性管理类
书籍类型:经典原理
清单覆盖 5/7
6 张卡片
来源书籍
代码可读性与重构类
书籍类型:经典原理
清单覆盖 7/7
127 张卡片
来源书籍
书籍类型:未标注
53 张卡片
来源书籍
软件架构方法论类
书籍类型:经典原理
类别清单尚未核对
83 张卡片
来源书籍
软硬件协同与硬件加速类
书籍类型:未标注
类别清单尚未核对
274 张卡片
来源书籍
高可用与云架构风险管理类。依据:全书主要处理服务拆分后的可用性、依赖故障、双活、演练与运行观测;云迁移并非本书核心内容,清单中未讲的维度如实记缺口。第13章虽提及Kubernetes和Service Mesh,本书并非以容器编排平台上的交付与运维为主要目标,故不按“云原生微服务实战类”核对。
书籍类型:工程实践
清单覆盖 6/7
379 张卡片
来源书籍
系统架构类
书籍类型:工程实践
清单覆盖 7/7
424 张卡片
来源书籍
工程管理/团队协作类
书籍类型:经典原理
清单覆盖 4/6
132 张卡片
主题索引
比较主备、主从、集群、分区与异地多活等高可用架构的适用范围、数据同步与代价。
主题索引
比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。
主题索引
比较缓存穿透、雪崩、热点等问题的成因与应对方案。
主题索引
比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。
主题索引
比较用类图、状态图刻画领域概念与关系的方法,以及领域建模如何促进沟通、破解分析瘫痪、决定并受功能扩展驱动。
主题索引
比较功能放在软件还是硬件的判断依据:灵活性与效率、迭代节奏、规模与成本、ASIC/FPGA 配比、接口设计与集成形态,以及软件定义硬件与软硬件融合的差异。
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类