整洁架构·中文 · clean-architecture-zh 的错误处理范式,我总结了 6 条规则

104
整洁r/clean-architecture-zh·由 huang_ke 发布·32 分钟前讨论

clean-architecture-zh 的错误处理范式,我总结了 6 条规则

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

// 最小复现:注意这里必须用真实的长尾分布,
// 均匀分布的压测流量不会触发这个问题
func (s *Server) handle(ctx context.Context) error {
    conn, err := s.pool.Acquire(ctx)
    if err != nil {
        return fmt.Errorf("acquire: %w", err)
    }
    defer conn.Release()

    return s.do(ctx, conn)
}

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

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

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

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

36 条评论

36 条评论

我
Zzhu_zong·28 分钟前

想请教一下,这个方案在容器里(内存限制 512Mi)会有什么变化?我们线上就是这么配的。

435
Sswoole_lee·12 分钟前已编辑

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

46
Mmike_xu·1 小时前

贴一下我们的实测数据,8 核 16G,同样的场景:

| 并发 | P50 | P99 |
|---|---|---|
| 200 | 12ms | 88ms |
| 500 | 31ms | 340ms |

P99 在 500 并发时明显崩了,和你说的拐点基本吻合。

30
Ddev_zhou·1 小时前

这里其实有个更简单的做法,不需要改架构:把这一层判断提前到网关,问题就消失了。代价是网关会多一次查表。

27
Mmike_xu·昨天

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

392
Bbob_chen·3 分钟前

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

391
Kkite·3 分钟前已编辑

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

340
Mmike_xu·2 天前

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

384
Oops_wang楼主·昨天

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

154
Aalice_dev版主·2 天前

想请教一下,这个方案在容器里(内存限制 512Mi)会有什么变化?我们线上就是这么配的。

34
Ddev_zhou·3 分钟前已编辑

这里其实有个更简单的做法,不需要改架构:把这一层判断提前到网关,问题就消失了。代价是网关会多一次查表。

380
Lli_ming楼主·28 分钟前

有没有人做过对照实验?我做了一组,把变量控制到只剩这一个,结果差距只有 4%,基本在噪声范围内。所以我觉得主因可能不是这个。

237
Ttang_hao·28 分钟前

我们生产环境用了两年,没遇到过。不过我承认我们没上到这个量级,所以这个结论对我们没有参考价值。

264
Hhuang_ke·2 天前已编辑

楼主说的第 3 点我有不同看法。这里的取舍取决于你的读写比:读多写少的话,加缓存反而会放大不一致窗口。

36
Zzhou_yi·2 天前

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

195
Lli_ming楼主·2 天前

楼主这个排查思路值得学习。我们之前是直接从日志下手,绕了很大一圈。

89
Nnikic·2 天前

楼主这个排查思路值得学习。我们之前是直接从日志下手,绕了很大一圈。

99
Ttang_hao·28 分钟前

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

93
Zzhou_yi·2 天前

贴一下我们的实测数据,8 核 16G,同样的场景:

| 并发 | P50 | P99 |
|---|---|---|
| 200 | 12ms | 88ms |
| 500 | 31ms | 340ms |

P99 在 500 并发时明显崩了,和你说的拐点基本吻合。

67
Nnikic·2 天前

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

66
Sslow_query·2 小时前

同意上面说的。补充一点:如果开了这个选项,监控指标里的 GC 次数会翻倍,需要同步调整告警阈值,否则会一直误报。

62
Llinlin·2 小时前

楼主说的第 3 点我有不同看法。这里的取舍取决于你的读写比:读多写少的话,加缓存反而会放大不一致窗口。

2
Cchen_dev·2 天前

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

24
Zzhou_yi·2 天前

已收藏。正好这周要改这块,少走很多弯路。

19
Rrase·刚刚

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

1
Oops_wang·12 分钟前

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

32
Bbob_chen·5 小时前已编辑

我们生产环境用了两年,没遇到过。不过我承认我们没上到这个量级,所以这个结论对我们没有参考价值。

15
Sswoole_lee·28 分钟前

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

276
Sslow_query·12 分钟前

贴一下我们的实测数据,8 核 16G,同样的场景:

| 并发 | P50 | P99 |
|---|---|---|
| 200 | 12ms | 88ms |
| 500 | 31ms | 340ms |

P99 在 500 并发时明显崩了,和你说的拐点基本吻合。

1
Zzhu_zong·刚刚

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

11
Cchen_dev·1 小时前

楼主这个排查思路值得学习。我们之前是直接从日志下手,绕了很大一圈。

211
Nnikic·2 天前

有没有人做过对照实验?我做了一组,把变量控制到只剩这一个,结果差距只有 4%,基本在噪声范围内。所以我觉得主因可能不是这个。

426
Wwinter·5 小时前

同意上面说的。补充一点:如果开了这个选项,监控指标里的 GC 次数会翻倍,需要同步调整告警阈值,否则会一直误报。

2
Lli_ming版主·昨天

已收藏。正好这周要改这块,少走很多弯路。

1
Wwinter·刚刚

有没有人做过对照实验?我做了一组,把变量控制到只剩这一个,结果差距只有 4%,基本在噪声范围内。所以我觉得主因可能不是这个。

62
Zzhu_zong·1 小时前

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

1

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

看数据表设计 →