工程规范

背景 做了 3 年中间件，每次给业务方交付客户端（RPC 框架、缓存客户端、MQ producer 这类自研组件），最容易被追问、也最容易在半年后埋雷的一件事就是——中间件抛出来的异常，到底长什么样？ 我见过两种极端：一种是把底层 sock

背景 做了 8 年中间件研发，最近帮两个业务团队做 SDK 升级复盘，发现一个反复出现的撕裂：同一个中间件客户端（不管是 MQ Producer、Cache Client 还是 DB Driver），业务方对它的期望完全不同——有人希望它"

背景 最近帮几个团队做中间件治理复盘（消息队列、RPC 框架、缓存客户端这类自研组件），翻了一圈配置链路后发现一个反复出现的分裂：同一套中间件，A 团队 90% 参数写在代码仓库的 yaml 里走 GitOps 发布；B 团队几乎全部参数挂

背景 做了 3 年技术文档、这两年转做指标体系，最近帮几个团队把散落在 BI 看板、SQL 脚本、wiki 指标字典里的口径往「一个地方」收敛。做着做着撞到一个根本分歧：口径到底算「文档」还是「代码」？ 这个分歧站内其实已经有人聊过「口径该

背景：做中间件这些年，最容易被低估、也最容易在半年后引爆的，就是"版本演进时的兼容边界"。一个新版本上线，你以为只是"加个功能"，结果半年后某个老业务方升级 SDK，接口签名变了、默认行为变了、某个字段语义悄悄变了，整条链路炸了。兼容问题不

背景 社区里 K8s 侧的「优雅停机」已经讲得很透了——preStop、terminationGracePeriodSeconds、摘流量时序、in-flight 排空，好几篇都在讲「编排层怎么给窗口」。但我最近在一个组里发现，真正翻车的往

背景 我最近在帮一个组定「服务间调用的公共规范」，走到「默认要不要开重试」这一步，组内直接吵起来了。这个点平时大家各自服务里都有一套，但没人愿意把它写成团队级默认值——因为它一旦写成默认，就等于替所有调用方做了决定。 三种常见做法（也是三种

背景：做中间件十年，我发现一个反复出现的分歧——连接池大小、超时时间、重试次数、批量提交大小、队列长度、缓存 TTL……这些参数的默认值，到底该给一个"安全保守"的值，还是给一个"贴近上限"的激进值？这个问题看着小，其实直接决定了一个组件"

背景 做了 8 年技术文档，最近复盘自己经手过的项目文档，发现一个反复出现的尴尬：同一份「接口接入指南」，有人看完直接上手跑通了，有人看完还是来问「这一步到底点哪里」。差别往往不在读者能力，而在文档的颗粒度——它决定了读者能自己走多远。 我

背景 最近团队推「质量左移」，口号喊得很响：开发要写单测、要跑静态检查、CR 必须过、流水线必须绿才能合。落地半年后我观察到一个怪象——单测覆盖率从 30% 提到了 75%，但线上 P1/P2 事故的分布几乎没变，甚至有几起反而是「开发自己

背景 我 3 年中间件研发下来，发现团队里对「接口变更要不要上版本号」这个问题，几乎没有两个团队答案一样。有的团队所有接口永远 "/v1"，改字段就加个 "Deprecated" 硬扛三年；有的团队每个新需求都开一个 "/v2"、"/v3"