整洁架构·中文 · 从 0 到 1 用 clean-architecture-zh 搭建内部平台:架构图与决策记录

21
整洁r/clean-architecture-zh·由 mike_xu 发布·2 小时前求助

从 0 到 1 用 clean-architecture-zh 搭建内部平台:架构图与决策记录

先说结论:clean-architecture-zh 这套东西在中小规模下几乎不需要调优,真正开始难受的位置比大多数人以为的靠后得多。下面是完整的实测过程。

-- 出问题的那条查询:在 2000 万行上做了全表扫描
-- 加复合索引后 P99 从 1.8s 降到 42ms
SELECT id, title, created_at
  FROM posts
 WHERE community_id = ?
   AND status = 1
 ORDER BY score DESC
 LIMIT 20;

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

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

关于取舍,我的判断是:如果团队里没有人长期盯这块,就不要引入第二套机制。两套并存的时候,出问题时你甚至要先花时间判断「这次是哪个在起作用」,那个成本比性能损失高得多。

6 条评论

6 条评论

我
Kkite·12 分钟前

刚翻了下 clean-architecture-zh 的源码,作者在注释里其实解释过为什么这么设计,大意是「为了在极端情况下退化成可预期行为」。

79
Aalice_dev·刚刚

能不能给出最小复现?我本地跑了十分钟没复现出来,环境是 macOS + 最新版。

5
Kkite·12 分钟前

这不是 clean-architecture-zh 的问题,是用法的问题。文档里写了这个 API 不是线程安全的,要自己在外面加锁。

56
Lli_ming·12 分钟前

感谢分享真实数据,比很多只讲概念的文章有用得多。

53
Cchen_dev·12 分钟前

这个结论和我们线上的观察一致。我们是在 QPS 到 3k 之后才撞上这个问题的,前压测阶段完全看不出来——因为压测流量太「干净」了,没有长尾请求。

505
Kkernel_panic·刚刚

补充一个反例:如果 clean-architecture-zh 的版本低于 7.4,这段代码的语义是不一样的,别照抄。我们在灰度环境踩过,回滚了一次。

96

这是帖子详情页 /zh-CN/c/clean-architecture-zh/post/p8。帖子与评论都由种子随机数确定性生成 —— 同一个帖子每次打开内容一致,因此可以直接分享链接、刷新、被搜索引擎收录。真实实现里这一页是 MySQL 读帖子 + Redis 缓存热帖 + 评论树按 path 字段一次性取出。

看数据表设计 →