Procházet zdrojové kódy

docs(deploy): testing 部署回执 d363df8056(FAILED:目标提交含 butlerResourceMatchService followUpMapper bean名冲突启动阻断,部署链自动回滚,线上维持 c2180785 构建)

zxyj-langgraph před 1 dnem
rodič
revize
178a6e046

+ 81 - 0
docs/tdd/orchestration/report-deploy-2026-11-14-d363df8056.md

@@ -0,0 +1,81 @@
+# 部署回执:d363df805 → testing(2026-11-14 20:20)
+
+## 结论
+
+**目标提交 `d363df8056d759cabeef2d6d281092b8d55160dc`(S-cfc-352 配套:SC-H-05 butler.resource.match,
+`ButlerResourceMatchService` 资源匹配服务)部署 FAILED —— 目标提交自身含启动阻断缺陷,部署链自动回滚,
+目标改动**未**真实运行在 testing 环境。**
+
+部署链(`/home/iwt/cfc-deploy-251.sh`,cron `*/10`)自 2026-11-14 14:45 起对包含目标提交的每个
+origin/cfclub HEAD 均执行「构建 → 安装 → 启动 → 启动失败 → 回滚」:Spring 上下文初始化被取消,
+`BeanCreationException: Error creating bean with name 'butlerResourceMatchService'` →
+`BeanNotOfRequiredTypeException: Bean named 'followUpMapper' is expected to be of type
+'ButlerResourceFollowUpMapper' but was actually of type 'com.sun.proxy.$Proxy389'`,
+`APPLICATION FAILED TO START`。部署链回滚至上一版健康 JAR。
+
+## 根因(目标提交自身代码缺陷,非部署链问题)
+
+`ButlerResourceMatchService`(目标提交新增)以字段名注入:
+
+```java
+@Resource
+private ButlerResourceFollowUpMapper followUpMapper;
+```
+
+Spring `@Resource` **按 bean 名优先解析**。MyBatis-Plus 已将**既有** `FollowUpMapper` 接口注册为
+bean 名 `followUpMapper`(接口简单名首字母小写),故 Spring 将类型为 `FollowUpMapper` 的 JDK 代理
+(`$Proxy389`)注入到类型为 `ButlerResourceFollowUpMapper` 的字段 → 类型不匹配
+`BeanNotOfRequiredTypeException` → 上下文初始化取消 → 应用无法启动。
+
+修复方向(属研发侧,非本次部署职责):字段重命名为 `butlerResourceFollowUpMapper`,或
+`@Resource(name = "butlerResourceFollowUpMapper")` 显式指定 bean 名,或用 `@Qualifier`/`@Autowired` 按类型注入。
+
+## 部署证据
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `d363df8056d759cabeef2d6d281092b8d55160dc`(feat(butler): 实现资源匹配服务 SC-H-05;10 文件 +706 行,含 ButlerResourceMatchService.java / ButlerResourceMatchResult.java / ButlerResourceFollowUp.java / ButlerResourceMatchLog.java / 3 个 Mapper / DatabaseInitializer.java / schema.sql) |
+| 目标首次部署尝试 | 14:45:36 已安装新 JAR(构建快照 @ d363df8056,PID=1124727)→ 14:45:58 **启动失败**(butlerResourceMatchService bean 注入异常)→ 14:46:05 回滚至上一版(PID=1131048 健康通过) |
+| 后续每轮复现 | 14:55 / 15:05 / 15:15 / 15:25 / 15:35 / 15:45 / 16:05 / 16:25 / 16:35 / 16:55 / 17:05 / 17:25 / 17:35 / 17:55 / 18:15 / 18:24 / 20:06 每轮同因启动失败并回滚(cfclub 主线无修复提交,缺陷持续存在于所有包含目标提交的 HEAD) |
+| 实际线上 JAR(state md5 与磁盘一致) | md5 `2e116d30e16cc6d4b215f99999c3892f`,类时间戳 2026-11-14 14:31,即 **c2180785 构建**(14:36:35 安装、14:37:03 健康通过的最后一次成功启动版) |
+| 运行进程 | PID=691468(20:07:22 启动,健康通过),`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar` |
+| 目标改动是否在线上 | **否**:线上 JAR 无 `ButlerResourceMatchService/ButlerResourceMatchResult/ButlerResourceFollowUp/ButlerResourceMatchLog` 类(`unzip -l` 仅见既有 `ButlerController/ButlerService/ButlerSessionService` 等),目标 10 文件未打入线上 JAR |
+| 祖先关系 | `git merge-base --is-ancestor d363df8056 eae6d6aba` → 成立(目标提交确在 origin/cfclub 主线,但无法启动,非部署链漏检) |
+| 根因源码(目标提交) | `cfc-backend/.../service/ButlerResourceMatchService.java:45-46`:`@Resource private ButlerResourceFollowUpMapper followUpMapper;` 与既有 `com.etotem.cfc.mapper.FollowUpMapper`(bean 名 `followUpMapper`)冲突 |
+
+## 部署链最终日志(/home/iwt/cfc-deploy.log)
+
+```
+14:45:36 已安装新 JAR
+14:45:58 [ERROR] 新版本启动失败,执行回滚
+14:46:05 回滚成功,服务已恢复(上一版本)
+20:06:57 已安装新 JAR
+20:07:21 [ERROR] 新版本启动失败,执行回滚
+20:07:51 回滚成功,服务已恢复(上一版本)
+20:07:55 部署完成: commit=eae6d6aba \ 后端: 401 \ 前端: 200 \ H5: 200   ← state 记录为 auto-bump commit
+```
+
+> ⚠️ **state 文件失真(部署脚本缺陷,需知悉)**:回滚路径将 `ACTUAL_COMMIT` 置为 `$LAST_COMMIT`(真实运行版本),
+> 但脚本 auto-bump 步骤(提交并推送 `chore: auto bump...` 后)**覆盖** `ACTUAL_COMMIT=$(git rev-parse HEAD)`,
+> 故 `/home/iwt/.cfc-deploy-state` 的 `last_commit=eae6d6aba` 为 auto-bump commit(新 HEAD),
+> 而实际线上 JAR 仍为 c2180785 构建(state `backend_jar_md5=2e116d30` 与磁盘一致,印证线上 JAR 未变)。
+> 部署链在启动失败回滚场景下会把"新 HEAD"误记为已部署,需研发/部署侧修正脚本(回滚时不执行/不覆盖 ACTUAL_COMMIT)。
+
+## 健康回执(回执出具时直连探测,2026-11-14 20:20)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端(部署基线) | `POST http://localhost:9082/api/admin/foods/list` | 401(无 token 预期)✓ |
+| 登录端点(PUBLIC_PATHS 例外) | `POST http://localhost:9082/api/admin-auth/login` | 200 ✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 线上 JAR 状态 | md5 `2e116d30...` = state `backend_jar_md5` | 一致 ✓(但为 c2180785 构建,非目标提交) |
+
+## 说明
+
+- 按编排要求,本次**未创建/修改** `.workbuddy/tasks.json`,未写 `last_deployed`;
+  `--deploy-done` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- **部署结果:FAILED**。目标提交自身含启动阻断缺陷(`followUpMapper` bean 名冲突),部署链已自动回滚保持线上
+  c2180785 构建可用。目标改动未进入线上 JAR,**勿**将 `d363df8056` 或 `eae6d6aba` 记为已部署。
+- 建议转研发侧:修复 `ButlerResourceMatchService` 注入(字段改名 / `@Resource(name=...)`)后重新派发部署;
+  并修正部署脚本回滚路径的 `ACTUAL_COMMIT` 覆盖问题。