From c434ef574338d30806e9dcadeaab4181b0a41d9d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 22 May 2026 14:19:58 +0800
Subject: [PATCH] =?UTF-8?q?append=20hotfix=20#2881=20(#2880)=20AdminOrderS?=
 =?UTF-8?q?tatusLogController=20=E8=B7=AF=E5=BE=84=E5=9B=9E=E6=BB=9A:=20PR?=
 =?UTF-8?q?=20#2864=20=E5=BC=95=E5=85=A5=20Ambiguous=20handler=20500=20?=
 =?UTF-8?q?=E5=9B=9E=E5=BD=92=E5=B7=B2=E9=97=AD=E7=8E=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...22_2863-2865_QA-D+QA-E-bugs_PR2864-2866.md | 21 ++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/changelogs-v2/2026-05/22_2863-2865_QA-D+QA-E-bugs_PR2864-2866.md b/changelogs-v2/2026-05/22_2863-2865_QA-D+QA-E-bugs_PR2864-2866.md
index 977ff29..1c9b12b 100644
--- a/changelogs-v2/2026-05/22_2863-2865_QA-D+QA-E-bugs_PR2864-2866.md
+++ b/changelogs-v2/2026-05/22_2863-2865_QA-D+QA-E-bugs_PR2864-2866.md
@@ -118,10 +118,25 @@ order.tags[0].color  // 用于显示标签底色
 
 ---
 
-## 五、关联
+## 五、hotfix #2881(回滚 PR #2864 引入的回归)
 
-- 工单: #2863 / #2865(全部 closed)
-- PR: #2864 / #2866(全部 squash merged)
+QA 真测验证 PR #2864 时发现 `/v3/admin/order/{id}/status-log` 返 500 Ambiguous handler。PR #2864 误把 wx 故意写的 `AdminOrderStatusLogController @RequestMapping("/admin/order")`(被 v2 抢截 404,设计上的"隐藏入口",PRP § 9 R13)改成 `/v3/admin/order`,反而与 OrderController 早就存在的同 URL 端点撞冲突。
+
+**hotfix PR #2881 (#2880)**:
+- AdminOrderStatusLogController 路径回滚 `/v3/admin/order` → `/admin/order`(故意 404 设计)
+- AdminOrderStatusLogControllerTest 3 处 mockMvc 同步回滚
+- javadoc 加大量警告注释 + 历史教训("严禁改 v3 前缀,会与 OrderController 撞 URL")
+
+**保留 PR #2864 其他改动**:gateway 5 路由追加(complaint/review/internal-review/internal-mp-review/internal-house)是真 bug 修复,保留。
+
+**最终验证**(部署后):
+- `/v3/admin/order/{id}/status-log` code=200,真返 `List<LogTimelineVO>` 1 条(occurredAt/operator/action/fromStatus/toStatus/amount 6 字段)
+- `/admin/order/{id}/status-log` code=404 维持设计
+
+## 六、关联
+
+- 工单: #2863 / #2865 / #2880(全部 closed)
+- PR: #2864 / #2866 / #2881(全部 squash merged)
 - QA 报告:
   - `.tmp/qa-house-report.txt`(QA-A 46 项)
   - `.tmp/qa-ord-report.txt`(QA-B 53 项)