Prechádzať zdrojové kódy

docs(deploy): 4c0ff6729 部署回执更新——SUCCESS(fix 17829760 落地后部署链部署 f3699cf64 成功,目标已运行 testing;并行精确部署回滚未影响)

zxyj-langgraph 4 dní pred
rodič
commit
f57e524894

+ 26 - 46
docs/tdd/orchestration/report-deploy-2026-11-14-4c0ff6729.md

@@ -1,63 +1,42 @@
-# 部署回执:4c0ff6729 → testing(2026-11-14 22:30)
+# 部署回执:4c0ff6729 → testing(2026-11-14 22:43)
 
 ## 结论
 
-**目标提交 `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369 测评预约创建前校验所选规划师 ∈ 家庭已绑定 T 列表)部署 FAILED —— 目标提交自身含启动阻断缺陷(与 d363df8056 同源:`butlerResourceMatchService` bean 名冲突),部署链自动回滚,目标改动**未**真实运行在 testing 环境。**
+**目标提交 `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369 测评预约创建前校验所选规划师 ∈ 家庭已绑定 T 列表)已真实部署并运行在 testing 环境,部署成功。**
 
-testing 当前线上版本为 **`c2180785a3e186bbff59798a594beb8e5a0cef7e`**(构建于 2026-11-14 14:31,md5 `2e116d30e16cc6d4b215f99999c3892f`,最后一次成功启动版)。目标提交 `4c0ff6729` **不是** `c2180785` 的祖先:
-`git merge-base --is-ancestor 4c0ff6729 c2180785` → **不成立**,目标改动未打进线上 JAR。
+testing 当前线上版本为 **`39b8d7fed81a58864b2f9d5d63c6e919030de168`**(部署链 22:34:13 写入 state,其后 22:41 并行精确部署回滚后 state 复写为同一值),其纯净构建源为 **`f3699cf64a9315f8d003dc114a3296594d9d2193`**(= `17829760` 启动阻断修复 + 目标提交 + 本回执 docs 提交)。`git merge-base --is-ancestor 4c0ff6729 39b8d7fe` → 成立,且目标 2 个后端文件在 `4c0ff6729..39b8d7fe` 间 **0 行差异(字节一致)**,目标改动完整打进线上 JAR 并通过健康检查。
 
-## 根因(目标提交自身代码缺陷,非部署链问题)
+## 部署方式与过程(含一次启动阻断阻塞 + 修复落地)
 
-目标提交 `4c0ff6729` 含 `d363df8056`(`feat(butler): 实现资源匹配服务 SC-H-05`)引入的启动阻断缺陷:
+1. **初始阻塞**:目标提交 `4c0ff6729` 自身含 `d363df8056` 引入的启动阻断缺陷(`ButlerResourceMatchService` 字段 `@Resource private ButlerResourceFollowUpMapper followUpMapper;` 与既有 `FollowUpMapper` bean 名 `followUpMapper` 冲突 → `BeanNotOfRequiredTypeException` → Spring 上下文取消 → `APPLICATION FAILED TO START`)。部署链自 14:31 起每轮(14:45/…/22:14)构建 → 安装 → 启动失败 → 回滚,线上维持 `c2180785` 构建(md5 `2e116d30...`),目标改动**未**在线上(`javap` 运行 JAR 无 `requireBoundPlanner`/`guideFamilyService`/`请先绑定规划师`;无 `ButlerResourceMatch*` 类)。
+2. **修复落地**:研发侧提交 `17829760`(`fix(butler): 修复 @Resource Bean 撞名致 Spring 启动阻断`,字段重命名 `followUpMapper` → `butlerResourceFollowUpMapper`,含同类 `HealthDataSourceBridgeService` 修复)入 `origin/cfclub`,且为目标的祖先。
+3. **部署链执行**:`/home/iwt/cfc-deploy-251.sh`(部署链:origin/cfclub 更新检测 → 纯净 worktree 构建 → JAR 校验 → 停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 产物部署 → 最终验证 → auto-bump 回写 + 写 state)检测更新至 `f3699cf64`,22:29:13 后端构建成功 → 22:31:21 前端构建成功 (v1.0.2500) → 22:33:33 部署 commit `f3699cf64` → 22:33:39 装新 JAR → 22:34:05 **`Started CfcApplication in 25.607s`(PID 2460172)** → 22:34:07 后端健康通过(401) → 22:34:13 写 state(`39b8d7fe`,auto-bump commit)。
+4. **并行精确部署回滚(已自愈,非本部署责任)**:22:35 起另一会话 `cfc-deploy-precise.sh`(目标 `677e6153d1`)在 22:40:29 备份当前 JAR → 22:40:32 安装其 JAR(PID 2533180)→ 22:40:59 **启动失败**(`677e6153d1` 自身亦含启动阻断)→ 22:41:00 回滚**恢复本部署 JAR**(md5 `722be485`,PID 2546904)→ 22:41:31 健康通过(401) → 22:41:31 state 复写 `39b8d7fe`。**回滚恢复的即本部署的 `f3699cf64` 构建 JAR,目标改动仍在线上。**
 
-```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 前后)
+| 目标提交 | `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369:AssessmentAppointmentController +21/-1、AssessmentAppointmentService +18,2 文件 +38/-1) |
+| 实际线上 commit(state) | `39b8d7fed81a58864b2f9d5d63c6e919030de168`(22:34:13 写入 state,22:41 精确回滚后复写一致) |
+| 构建源 commit | `f3699cf64a9315f8d003dc114a3296594d9d2193`(22:29 纯净 worktree 构建,含目标 + 修复 `17829760`) |
+| 祖先关系 | `git merge-base --is-ancestor 4c0ff6729 39b8d7fe` → 成立(目标改动已进构建源) |
+| 源码一致性 | `git diff 4c0ff6729..39b8d7fe -- <2 个目标后端文件>` → **0 行**(字节一致,目标版本完整进 JAR,其后无回退/改写) |
+| JAR 内容校验 | 线上 JAR(md5 `722be4853718d3f1e7e413d6696f104e` = state `backend_jar_md5` 一致)内含:`AssessmentAppointmentService.class` 的 `public boolean requireBoundPlanner(java.lang.Long, java.lang.Long)` 方法(javap 证实)、常量池 `guideFamilyService`/`isBound`/`requireBoundPlanner`;`AssessmentAppointmentController.class` 常量池 `guideFamilyService`/`requireBoundPlanner`/`请先绑定规划师`;`ButlerResourceMatchService.class` 含修复字段 `butlerResourceFollowUpMapper` |
+| 部署时间轴 | 22:29:13 后端构建成功 → 22:31:21 前端构建成功 → 22:33:33 部署 commit → 22:33:39 装新 JAR + 启动 PID 2460172 → 22:34:05 `Started CfcApplication` → 22:34:07 健康通过(401) → 22:34:13 写 state;22:41 并行精确回滚后 PID 2546904 健康通过(401) |
+| 部署 state | `/home/iwt/.cfc-deploy-state`: `last_commit=39b8d7fe...` `backend_jar_md5=722be4853718d3f1e7e413d6696f104e` |
+| 运行进程 | PID 2546904,`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar`,22:41:00 启动,健康 |
+| 回滚 | 本部署启动健康检查一次通过(22:34:07),未触发回滚;后续并行精确部署(677e6153d1)失败回滚至本部署 JAR |
+
+## 健康回执(回执出具时直连探测,2026-11-14 22:43,连续 3 次稳定)
 
 | 目标 | 探测 | 结果 |
 |------|------|------|
 | 后端(部署基线) | `POST http://localhost:9082/api/admin/foods/list` | 401(无 token 预期)✓ |
+| 目标控制器端点 | `POST http://localhost:9082/api/assessment/appointment/create` | 200(路由已注册,非 404;对照 `/list` → 404)✓ |
 | 管理端 | `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`)不在线上;修复提交落地后需重新部署并复验。
+| 后端 JAR 状态 | md5 `722be485...` = state `backend_jar_md5` | 一致 ✓ |
 
 ## 说明
 
@@ -65,5 +44,6 @@ Spring `@Resource` **按 bean 名优先解析**。MyBatis-Plus 已将**既有**
   `--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` 构建)。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done testing --commit` 落盘):`39b8d7fed81a58864b2f9d5d63c6e919030de168`**
+  (state `last_commit`,= 构建源 `f3699cf64` + 前端元数据 auto-bump;目标 `4c0ff6729` 为其祖先、2 个目标文件字节一致,已真实运行在 testing)。
+  注:若编排侧以构建源为准,亦可使用 `f3699cf64a9315f8d003dc114a3296594d9d2193`(后端代码树一致)。