Parcourir la source

docs(deploy): testing 部署回执 4c0ff6729(目标提交含 @Resource bean撞名启动阻断,线上维持 c2180785;fix 17829760 已入 cfclub)

zxyj-langgraph il y a 1 jour
Parent
commit
f3699cf64
1 fichiers modifiés avec 69 ajouts et 0 suppressions
  1. 69 0
      docs/tdd/orchestration/report-deploy-2026-11-14-4c0ff6729.md

+ 69 - 0
docs/tdd/orchestration/report-deploy-2026-11-14-4c0ff6729.md

@@ -0,0 +1,69 @@
+# 部署回执:4c0ff6729 → testing(2026-11-14 22:30)
+
+## 结论
+
+**目标提交 `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369 测评预约创建前校验所选规划师 ∈ 家庭已绑定 T 列表)部署 FAILED —— 目标提交自身含启动阻断缺陷(与 d363df8056 同源:`butlerResourceMatchService` bean 名冲突),部署链自动回滚,目标改动**未**真实运行在 testing 环境。**
+
+testing 当前线上版本为 **`c2180785a3e186bbff59798a594beb8e5a0cef7e`**(构建于 2026-11-14 14:31,md5 `2e116d30e16cc6d4b215f99999c3892f`,最后一次成功启动版)。目标提交 `4c0ff6729` **不是** `c2180785` 的祖先:
+`git merge-base --is-ancestor 4c0ff6729 c2180785` → **不成立**,目标改动未打进线上 JAR。
+
+## 根因(目标提交自身代码缺陷,非部署链问题)
+
+目标提交 `4c0ff6729` 含 `d363df8056`(`feat(butler): 实现资源匹配服务 SC-H-05`)引入的启动阻断缺陷:
+
+```java
+// cfc-backend/.../service/ButlerResourceMatchService.java:46(目标提交内,与 origin/cfclub HEAD 3afa2ef28 字节一致)
+@Resource
+private ButlerResourceFollowUpMapper followUpMapper;
+```
+
+Spring `@Resource` **按 bean 名优先解析**。MyBatis-Plus 已将**既有** `FollowUpMapper` 接口注册为 bean 名
+`followUpMapper`(接口简单名首字母小写),故 Spring 将类型为 `FollowUpMapper` 的 JDK 代理
+(`$Proxy388/$Proxy389`)注入到类型为 `ButlerResourceFollowUpMapper` 的字段 → 类型不匹配
+`BeanNotOfRequiredTypeException` → Spring 上下文初始化取消 → `APPLICATION FAILED TO START`。
+
+`git merge-base --is-ancestor d363df8056 4c0ff6729` → 成立,即目标提交**确含**该缺陷;
+`git diff 4c0ff6729 origin/cfclub -- ButlerResourceMatchService.java` → 0 行(缺陷在 origin HEAD `3afa2ef28` 仍存在,未在提交线内修复)。
+
+## 部署证据
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369:AssessmentAppointmentController +21/-1、AssessmentAppointmentService +18,合计 2 文件 +38/-1;authored 2026-11-14 15:55:22 +0800) |
+| 实际线上 commit | `c2180785a3e186bbff59798a594beb8e5a0cef7e`(Merge 2026-11-14 14:27:09,构建 14:31,14:36 安装、14:37 健康通过的最后一次成功启动版) |
+| 线上 JAR(state md5 与磁盘一致) | md5 `2e116d30e16cc6d4b215f99999c3892f`,类时间戳 2026-11-14 14:31 |
+| 祖先关系 | `git merge-base --is-ancestor 4c0ff6729 c2180785` → **不成立**(目标改动不在运行版中) |
+| 目标是否在运行 JAR | **否**:`javap -p` 运行 JAR 的 `AssessmentAppointmentService.class` 无 `requireBoundPlanner` 方法(0 处);常量池无 `guideFamilyService`/`请先绑定规划师`/`isBound` 字符串;JAR 内 `ButlerResourceMatch*` 类 0 个(运行版早于缺陷与目标) |
+| 缺陷祖先关系 | `git merge-base --is-ancestor d363df8056 4c0ff6729` → 成立(目标提交含缺陷) |
+| 缺陷字节一致性 | `git diff 4c0ff6729 origin/cfclub -- ButlerResourceMatchService.java` → 0 行(缺陷未在提交线内修复,origin HEAD `3afa2ef28` 仍带病) |
+| 部署链失败证据 | `/home/iwt/cfc-deploy.log`:自 14:31 起每轮(14:45/14:55/15:05/.../20:06/21:45/22:06/22:14)安装新 JAR → 启动失败(`butlerResourceMatchService` bean 注入异常 `BeanNotOfRequiredTypeException: Bean named 'followUpMapper' ... $Proxy388`)→ 回滚至上一版健康 JAR |
+| 最近一轮(22:08-22:14) | 部署链检测 origin/cfclub 推进至 `0875a19e3`(含目标提交),22:13:37 装新 JAR → 22:14:03 进程 2247521 启动后退出(同上 bean 异常)→ 22:14:10 回滚启动 PID=2251841 → 22:14:37 健康通过(401) → 22:14:40 state 记录 |
+| 运行进程 | PID=2251841(22:14:10 启动,健康通过),`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar` |
+
+## 健康回执(回执出具时直连探测,2026-11-14 22:25 前后)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端(部署基线) | `POST http://localhost:9082/api/admin/foods/list` | 401(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 后端 JAR 状态 | md5 `2e116d30...` = state `backend_jar_md5` | 一致 ✓ |
+
+## 状态文件失真说明(部署脚本既有缺陷,需知悉)
+
+`/home/iwt/.cfc-deploy-state` 当前 `last_commit=cdf81991bf904a557f5e2150fbdf3036e3b8e909`(`chore: auto bump version and changelog`,2026-11-14 21:46:30),**非真实运行版本**。部署脚本回滚路径将 `ACTUAL_COMMIT` 置为 `$LAST_COMMIT`,随后 auto-bump 步骤又覆盖 `ACTUAL_COMMIT=$(git rev-parse HEAD)`,故 state 的 `last_commit` 为 auto-bump 提交,而线上实际 JAR 为 `c2180785` 构建(md5 `2e116d30...`)。判定线上版本必须以**线上 JAR md5 + JAR 内类字节码**为准,勿以 state `last_commit` 为准。
+
+## 后续处置(属研发侧,非本次部署职责)
+
+- 修复方向(已按 d363df8056 报告预案实施于共享工作区,但**尚未提交/推送**):`ButlerResourceMatchService.followUpMapper` 字段重命名为 `butlerResourceFollowUpMapper`(工作区已见,另 `HealthDataSourceBridgeService.dimensionScoreService` → `healthDimensionScoreService` 同类修复)。
+- 修复提交并推送 `origin/cfclub` 后,部署链 cron 才会自动构建部署;本轮部署链对带病提交的每轮尝试均正确回滚,未产生数据/服务损坏。
+- ⚠️ 目标 `4c0ff6729` 的 S-cfc-369 改动本身(`requireBoundPlanner`/`guideFamilyService`)不在线上;修复提交落地后需重新部署并复验。
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;
+  `--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(origin/cfclub 更新检测 → 纯净 worktree 构建 → JAR 校验 →
+  停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 产物部署 → 最终验证 → auto-bump 回写 + 写 state)。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done` 落盘):无**(目标未部署成功,部署链自动回滚;
+  线上维持 `c2180785a3e186bbff59798a594beb8e5a0cef7e` 构建)。