Defer后进先出
同一函数内已注册的多个 defer 按后进先出执行。若先获取资源 A、再获取资源 B,退出时应先释放 B、后释放 A;把清理语句写在每次成功获取资源之后,能让清理顺序与依赖关系一致。条件分支没有走到的 defer 不会注册。
主题对照
比较延迟执行、异常展开、恢复与返回值错误等机制的语义边界。
同一函数内已注册的多个 defer 按后进先出执行。若先获取资源 A、再获取资源 B,退出时应先释放 B、后释放 A;把清理语句写在每次成功获取资源之后,能让清理顺序与依赖关系一致。条件分支没有走到的 defer 不会注册。
return 不是一步完成的:先把返回值保存下来,再执行 defer,然后函数才真正返回。所以 defer 改得动的是已经放进命名返回值的那一份。
示例:书中第一个函数先 return g,defer 里再把 g 改成 200。调用方拿到的返回值仍是 100,g 自己变成 200。第二个例子在 defer 里给返回值赋值,调用方拿到 200。这种改写适合统一收尾,也会把控制流藏起来。
panic 不会立刻让整个进程退出。它先停掉当前函数后面的正常语句,执行这一层已经注册的 defer,再沿着调用栈往上返回。
示例:调用链是 a 调用 b、b 调用 c。c 发生 panic 后回到 b,b 也像发生了 panic 一样再回到 a。c、b、a 里已经注册的 defer 都会执行。它适合走不下去的异常路径,不要拿来代替普通的错误返回。
recover 要写在 defer 函数里直接调用,才对得上当前这次展开。再包进另一层普通函数去调用,就恢复不了。
它只能截住当前函数或其调用的函数触发的 panic。书中内层函数里的 recover 截不住更外层已经在展开的 panic。适合放在明确的边界上隔离崩溃,不要用来盖住不该继续运行的状态。
throw 可抛出任意表达式,并把控制转给匹配的 catch;使用带 name、message 的错误对象是书中的建议,不是语法要求。一个 try 配一个 catch,处理器可按错误类型或属性分支。发散:异常用于上层处理异常情况,普通条件仍用显式分支。
硬件访问、通信和状态转换都会失败,如果每个模块各自发明错误码和恢复方式,系统会难以诊断。发散:一致的错误处理库把失败变成可传播、可记录、可测试的工程对象,而不是散落的 if 分支。
渲染引擎的原则是快速失败、大声失败。它从生产控制系统(PCS)取出任务后,先检查字体、背景图、alpha 遮罩等资源是否真的存在,缺了就立刻报错并停掉,而不是做到一半才发现。16 步管道里前 5 步都是检查。
书中的反例是没有事先为渲染结果留出磁盘空间。这项检查没做,直到磁盘写满才失败。要提前发现的失败,必须真的写进前面的检查。
JPC团队定下边界:Exception是异常,Error是错误——Exception该表达出现频率低但程序还能妥善处理的情形,不是代表毁灭性问题。把异常当常规分支用会让虚拟机没法针对通常路径优化;反过来为频繁出现的轻量异常预建静态单例复用,能省下重建调用栈的开销。这套标准把发生频率和是否继续运行分开考虑,比笼统套try-catch更精细。
不确定性源于我们对复杂系统的无知——不论用哪些维度或模型去观察描述一个系统,都无法完全覆盖它的所有方面。软件系统同样运行在充满不确定性的世界里:不管前期规划多完美、架构设计多合理、测试多全面,上线后依然会出现Bug——这些Bug本质上就是不确定性事件。防御性的作用,就是让我们承认系统运行中存在这种不确定性,并在意外事件发生时尽量把影响降到最低。冲突最容易发生的地方是边界——不分空间、物种、类型,只要存在实在的或虚拟的边界,就可能发生冲突。现实世界应对边界冲突有三种方法:阻断——在边界上把双方完全隔离(长城、石墙,建筑物功能区之间的隔离带);协议——双方约定何时、何种情况下不因边界上发生的事而冲突(国与国、企业与企业、人与人之间常见的约定手段);第三方仲裁——当冲突双方无法通过谈判或对抗解决问题时,引入第三方裁决。程序是一种”软”的边界,处理起来更灵活,但同样最容易在边界上出问题,而现实世界这三种防范思路可以直接映射到防御性编程的具体方法上。可迁移启发:诊断一个系统的薄弱点时,优先去检查各个模块/服务/团队交接的”边界”位置——凡是两个不同职责、不同团队、不同技术栈的东西交汇的地方,往往就是Bug和意外事件最集中爆发的地方,而不是任何一方内部逻辑最复杂的地方。
结构图:
flowchart TB
U["不确定性=对复杂系统的无知<br/>(即便规划测试完善,上线后仍有Bug)"]
U --> B["冲突高发地=边界<br/>(不分空间/物种/类型)"]
B --> M1["方法1:阻断(完全隔离,如长城/防火隔离带)"]
B --> M2["方法2:协议(约定何时不冲突,如国际条约)"]
B --> M3["方法3:第三方仲裁(谈判失败后引入裁决)"]
M1 -.映射.-> P["防御性编程六法(见后续卡片)"]
M2 -.映射.-> P
M3 -.映射.-> P
[[防御性的本质|现实世界应对边界冲突的三种方法]]直接映射到防御性编程的六种具体方法。对应”阻断”的有两种:身份认证——只在获得同意的情况下才允许访问,未经同意的一律拒绝(携带令牌、会话ID、签名等);最小知识法则——是阻断方法的延伸,允许调用方进入系统内部,但只给最小够用的授权(面向对象的封装原则、菜单权限、数据权限控制都是这一原则的应用)。对应”协议”的是契约式编程——调用方和被调用方通过约定尽量一次成功,即便不成功也及时止损并明确告知处理方式;一份良好的契约至少要包含前置条件(对输入参数、对调用方的要求,不满足时该如何处理)和后置条件(对输出结果、对被调用方的要求,包括返回结果的格式、字段取值范围,以及失败时如何告知失败原因)。对应”第三方仲裁”的是仲裁机制——当某个节点或服务无法自行察觉自身问题时,引入第三方监测其状态,发现问题后重启恢复或让其他节点接管(负载均衡本身就是一种仲裁机制;Redis、RabbitMQ集群模式下的仲裁程序了解所有节点状态,节点出问题时立即替换为其他可用节点)。此外还有两类应对”超出契约范围的未知错误”的方法:通信问题处理——重发(未收到结果或结果不符合契约时重新发送)、熔断/限流/降级(请求量超阈值时保护自身)、超时(响应过长时主动终止);资源处理问题——遵循”有始有终”原则,无论发生何种意外都要确保正确关闭已使用的资源,防止资源泄漏(Java里用try-catch-finally手动关闭资源,或更推荐的try-with-resources,后者在异常处理和资源释放上更简洁安全)。可迁移启发:设计一个新接口时,可以直接把这六种方法当作一份检查清单过一遍——有没有做身份认证、有没有把授权限制到最小够用、契约的前后置条件写清楚了没有、依赖的下游有没有仲裁机制兜底、通信失败时的重发/熔断/超时策略定义了没有、涉及的资源是不是保证了有始有终——六项里漏掉任何一项,这个接口在生产环境里都可能在某个边界条件下暴露出脆弱点。
结构图:
flowchart TB
A["阻断"] --> A1["身份认证(令牌/会话ID/签名)"]
A --> A2["最小知识法则(最小够用授权,如封装/权限控制)"]
P["协议"] --> P1["契约式编程(前置条件+后置条件)"]
R["第三方仲裁"] --> R1["仲裁机制(负载均衡/集群仲裁程序,监测并接管故障节点)"]
U["超出契约的未知错误"] --> U1["通信问题:重发/熔断限流降级/超时"]
U --> U2["资源处理:有始有终(try-with-resources)"]
错误状态继续运行会把根因拖远,并产生更难解释的次生故障。尽早崩溃不是粗暴退出,而是在无法满足假设时立即停止错误传播,让问题靠近源头。
停止的是已不可信的执行单元,并需按环境释放资源、处理未决事务或交给监管者。Erlang/Elixir监管树提供重启和清理框架;其他环境不能只退出而遗留半完成状态,也不能把合法业务拒绝都当崩溃。
警告可能揭示真实缺陷,不能因构建产出成功就忽略。可把适合项目的警告纳入失败门槛,并使本地与持续集成设置一致。已有项目突然收紧门槛可能阻断工作,应先识别和处理存量;确由编译器或第三方导致且无法消除的个别项,可有依据地定点处理,避免淹没真正问题。
异常需要明确处理责任:能恢复则恢复,不能处理则向合适调用者传播有意义的失败信息。原例空catch吞掉缺失组件异常,只返回null,使调用者失去根因。替换成没有上下文的NullPointerException同样无助诊断;也不是每种业务结果都应抛异常。记录与传播应服务定位,避免用补丁掩盖异常接口设计问题。
清楚说明失败发生在哪里、对当前操作意味着什么,并提供能定位技术细节的错误标识或入口。日志保留必要上下文,用户消息保持可理解,两者通过标识对应,避免在大量记录中盲找。不要直接向用户展示底层连接、SQL或敏感状态;增加信息必须同时控制访问和记录边界。
Node.js 的回调约定有两条:回调总是最后一个参数,即使前面有可选参数,这样内联定义回调时调用更易读;错误总是回调的第一个参数,成功时为 null 或 undefined,结果从第二个参数开始。错误必须是 Error 类型,不能传字符串或数字。自己设计异步 API 也应遵守,否则无法与生态互操作。
异步回调中抛出的异常不会沿调用方传播,而是跳到事件循环。在调用处包一层 try…catch 没用,因为回调运行在另一个栈上,那个栈的底部是事件循环而不是发起调用的函数。正确做法是在回调内部捕获可能抛错的代码(如 JSON.parse),把错误作为回调第一个参数传下去,并在传播错误后立即 return。
异常到达事件循环后,Node.js 会在退出前发出 uncaughtException 事件,给你一次清理或记录日志的机会。但此时应用处于无法保证一致性的状态:可能还有 I/O 在进行,闭包里的数据可能前后矛盾。因此收到未捕获异常后应退出进程,尤其是生产环境;靠监听这个事件让进程硬撑着运行是危险的。
EventEmitter 和回调一样不能靠抛异常报错:事件若是异步发出,异常会丢进事件循环。约定是发出名为 error 的特殊事件并传入 Error 对象。Node.js 对它特殊处理:如果没有注册 error 监听器,会自动抛出异常并使程序退出。所以使用任何发射器时都应注册 error 监听器。
即使 promise 用一个值同步地解决,onFulfilled 和 onRejected 也保证异步调用。这从机制上排除了第 2 章“有时同步有时异步”的 Zalgo 问题,异步代码因此更一致。另一个关键点是:处理函数里 throw 的异常会让 then 返回的 promise 自动被拒绝,异常沿链传播,throw 终于在异步代码里重新可用。
readable.pipe(writable) 自动把数据送进可写流并处理背压,源头结束时目标也会结束(除非传 {end:false}),返回值便于链式调用。但 error 事件不会沿管道传播:链尾注册的 error 监听器只能收到最后一个流的错误,每个流都要单独监听;目标流出错时管道还会与源流脱离。当前 Node.js 提供 stream.pipeline 统一处理错误与清理。
Promise代表尚未结束的过程的最终结果,只有待决、成功、失败三种互斥状态。then()注册两个处理函数(Reaction),分别处理成功与失败;每个then()都返回Promise,多个异步步骤就能串成一条链,错误可由失败Reaction或catch()处理。它把控制流变成可组合的对象;取消与超时原书未展开,需另行设计。
异步调用失败后Lambda会自动重试,仍未处理的事件转入死信队列(SQS或SNS),避免静默丢失。原书写“至少重试五次”与现行文档不符:默认最多再试两次,且即使没出错也可能重复收到同一事件。所以写操作必须幂等,死信要有人监控、重放,见[[核心指标画像]]。
函数的执行语义要显式声明:至少一次、至多一次或恰好一次。平台按至少一次投递时,同一事件可能被处理多次,写操作必须幂等:用CloudEvents要求唯一的“源+ID”作去重键,处理前先查重。失败事件进入死信队列只是隔离,还要告警、查因、在幂等前提下重放。
调用失败不能一律重试。平台用内部错误码区分:用户代码报的错原样返回调用方,重试也无济于事;部分系统错误(如实例临时不可用)才在合适的那一层重试。重试只放在一个位置,否则网关、调度器、代理层层都重试,一次故障会被放大成倍数级流量,即级联重试。
连接丢失的麻烦不在于请求失败,而在于不知道服务器是否已经执行了它:同步调用收到异常、异步调用收到错误码,都无法说明请求有没有生效。有些封装库简单地自动重发,这可能出错:创建领导节点时连接丢失,盲目重试会因节点已存在而失败,进程就误以为别人当选了。重试前要读取状态确认结果,见[[可恢复错误要重建意图]]。
重试的对象不应只是同一行调用,而是“这次协调意图是否已经达成”:先检查目标节点、版本和任务状态,再决定补写、跳过或重新注册。书中还举了反例:早期版本在会话失效后自动换新句柄,结果自以为仍是群首的进程通过新句柄继续改群首的数据;现在ZooKeeper保证句柄与会话一一对应,恢复必须由应用显式完成。
Curator在创建客户端时就要求给出重试策略,指定失去连接后如何重试;用原生接口时,这需要开发者自己重发请求。重试会影响请求是否被重复执行,所以它是协议设计的一部分,不能当作幂等保证。书中举例:创建有序节点时连接丢失,不知道建成了哪个名字,可用保护模式给节点名加唯一前缀,事后找回,见[[连接丢失结果未知]]。
BFE所有网络相关协程都用Go内置的恢复机制兜住运行时崩溃,一个未知缺陷通常只影响单个连接或请求,而不会让整个转发实例异常退出。恢复时输出的上下文日志还能帮助定位问题,很多难以线下复现的故障靠分析这些日志就能找到原因。入口系统不能假设没有缺陷,而要把故障限制在最小处理单元内。
Optional 是一个可能为空的值的容器:值存在时返回值,值为空时由调用方预先决定怎么处理,而不是在运行时抛出空指针异常。它把“可能缺失”写进方法的返回类型,迫使调用方处理存在和不存在两种情况。它不能替代领域建模,但能让空值风险在方法签名上就暴露出来。
@ControllerAdvice 用来集中处理所有控制器共享的逻辑:配合 @ExceptionHandler 统一处理异常,配合 @InitBinder 统一初始化参数绑定,还能通过属性限定生效范围。写在单个控制器里的 @ExceptionHandler 只对该控制器有效。统一规则放全局,业务特例留在局部,避免通用层承担太多上下文。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
编程语言类
书籍类型:未标注
清单覆盖 6/9
80 张卡片
来源书籍
编程语言类
书籍类型:经典原理
清单覆盖 8/9
182 张卡片
来源书籍
编程语言类
书籍类型:未标注
类别清单尚未核对
106 张卡片
来源书籍
JavaScript运行时与服务端工程类
书籍类型:工程实践
清单覆盖 5/6
174 张卡片
来源书籍
书籍类型:经典原理
146 张卡片
来源书籍
书籍类型:经典原理
142 张卡片
来源书籍
框架类
书籍类型:工程实践
清单覆盖 6/6
30 张卡片
来源书籍
Serverless架构类
书籍类型:工程实践
清单覆盖 7/7
26 张卡片
来源书籍
Serverless架构类
书籍类型:工程实践
清单覆盖 7/7
22 张卡片
来源书籍
Serverless架构类
书籍类型:工程实践
清单覆盖 7/7
74 张卡片
来源书籍
书籍类型:经典原理
312 张卡片
来源书籍
书籍类型:经典原理
125 张卡片
来源书籍
分布式系统类
书籍类型:工程实践
清单覆盖 7/7
49 张卡片
来源书籍
流量接入与负载均衡类
书籍类型:工程实践
清单覆盖 7/7
59 张卡片
来源书籍
框架类
书籍类型:工程实践
清单覆盖 7/7
48 张卡片
来源书籍
书籍类型:工程实践
33 张卡片
来源书籍
机器人与嵌入式系统实战类
书籍类型:未标注
清单覆盖 7/7
297 张卡片
来源书籍
安全/密码学类
书籍类型:工程实践
清单覆盖 7/7
215 张卡片
来源书籍
书籍类型:未标注
389 张卡片
来源书籍
系统架构类
书籍类型:未标注
清单覆盖 5/7
194 张卡片
来源书籍
软件架构方法论类
书籍类型:经典原理
类别清单尚未核对
88 张卡片
来源书籍
书籍类型:未标注
222 张卡片
来源书籍
代码可读性与重构类
书籍类型:经典原理
类别清单尚未核对
163 张卡片
来源书籍
软件架构方法论类
书籍类型:未标注
类别清单尚未核对
334 张卡片
来源书籍
系统架构类
书籍类型:工程实践
类别清单尚未核对
67 张卡片
来源书籍
系统架构类
书籍类型:工程实践
清单覆盖 7/7
424 张卡片
来源书籍
工程管理/团队协作类
书籍类型:经典原理
清单覆盖 4/6
132 张卡片
主题索引
比较嵌入式系统在资源约束下的硬件抽象、驱动与外设通信、执行器控制、固件更新与低功耗设计。
主题索引
无服务器平台在 Kubernetes 之上补齐的原语:构建、请求路由、事件交付与伸缩至零,以及事件格式标准化。
主题索引
比较 Future、回调、监听器与阶段式编排在阻塞、线程归属、组合与异常传播上的差异。
主题索引
比较多层防护、分段拦截与故障/入侵影响范围限制的设计方法。
主题索引
比较故障与失效、部分失效、网络与超时的不确定性、时钟漂移与进程暂停,以及系统模型如何界定这些假设。
主题索引
比较至少一次、最多一次、恰好一次与幂等的组合,确认、重投、死信与补偿怎样把「不丢不重」落成可实现的条件。
与 4 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;属于相同分类
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类