Editor·书单 · 把公司项目升级到最新版 editor-books，我踩了这 11 个坑

网上关于 editor-books 的文章大多停在「怎么用」，很少有人写「什么时候不该用」。这篇想补上后半句。

排查顺序（按性价比排）： 1. 先看下游 RT，八成问题不在自己身上 2. 再看连接池命中率与等待队列长度 3. 然后才是 GC 与内存分配 4. 最后才怀疑框架

监控这块我们也顺手改了：把原来的平均值告警换成分位数，并且按接口拆分。改完之后误报少了大概七成，值班同学的怨气肉眼可见地下降了。

最后提醒一个坑：容器环境下一定要记得同步调整内存相关的参数，否则宿主机的限制和进程内部的预期会对不上，表现就是偶发的、无法复现的失败。

第一件事是把变量收敛干净。我们最开始同时在改配置和升级版本，结果两组数据的差异根本说不清是哪个带来的。后来回滚到只动一个变量，重跑了三遍，曲线才稳定下来。这一步很枯燥，但省不掉。

真正让我意外的是长尾。平均值一直很漂亮，P99 却在某个阈值之后直接跳了一个数量级。原因不在 editor-books 本身，而是我们上游的连接复用没做好，压测流量太「干净」，掩盖了长尾请求。