From 2944b19e6f79ef770bc1013257427e4516dfa7a9 Mon Sep 17 00:00:00 2001 From: async-upgrade Date: Sun, 6 Sep 2026 16:47:55 +0800 Subject: [PATCH] docs: phase-3 deep regression results - 3 pre-existing bugs fixed, full auth-flow tests 17/17 --- docs/ARCHITECTURE.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index bac0817..4af6e57 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -113,6 +113,14 @@ BACKEND_URL=http://127.0.0.1:8000 pnpm dev # http://localhost:5173 - ✅ `docker compose config` 校验通过 - ✅ Nginx 配置语法 `nginx -t` 通过 - ✅ Phase-2 服务器回归：7/9 端点组全绿、写路径（短链/评论）异步落库、并发 240/240 +- ✅ Phase-3 全链路深度回归：公开 11/11 + 认证 6/6（JWT 登录/钱包/黑名单/短链/登录记录/任务）+ 并发 240/240，评论"创建→异步序列化→PG 持久化"全链路打通 + +### Phase 3：全链路深度测试暴露并修复的原有 Bug（非异步化回归，均已确认在改造前就存在） +1. `ArticleCommentSerializer.created_at` 缺字段级 `read_only=True` —— DRF/adrf 的 `Meta.read_only_fields` 对显式声明字段无效，导致**评论接口一直无法用**（前端只发 content/parent） +2. `@method_decorator(never_cache, name='dispatch')` 同步包装器在 adrf 协程上崩溃（wallet/login_record/tasks）—— 新增 `utils/async_decorators.py::async_never_cache_dispatch`（兼容同步/异步 dispatch） +3. `FUser` 没有 `nickname` 字段 —— article 通知/message sender_name/bug user_name 共 6 处改用 `first_name`（前两处一直被 Bug1 掩盖，从未执行到） + +> 教训：这三个 Bug 层层叠加掩盖——Bug1 让评论接口 400（走不到后面），Bug3 在 Bug1 修复后才暴露；never_cache 502 则在无认证流量时不可见。深度回归必须带认证流量。 ## 服务器部署（192.168.5.7 生产/联调环境）