离线优先·开源 · 把公司项目升级到最新版 offline-first-opensource，我踩了这 11 个坑

先说背景。我们的场景是 offline-first-opensource + 三个下游服务，日均请求量七位数，峰值集中在晚上九点前后。

# 压测命令：注意 -c 不要一次拉满，要阶梯上升
# 直接拉满会错过拐点
for c in 50 100 200 400 800; do
  wrk -t8 -c$c -d60s --latency http://127.0.0.1:8080/api/feed
  sleep 20
done

顺便说一句，官方文档里这段其实有写，只是藏在一个很不起眼的位置。我是在翻源码注释的时候才发现的，注释里作者解释了为什么这么设计 —— 大意是「为了在极端情况下退化成可预期的行为」。

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

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