fix(p21-2e): 红娘服务拦截接线（blocker 首次生效 + 竞态兜底）；2d 确认 Onboarding 本地资格已实现；文档回写

P16 遗留 2e（红娘服务拦截）：
- checkCanWithdraw 硬编码 0 → 接 MatchmakerServiceMapper.countActiveByUserId（非终态口径
  submitted/assigned/in_service/waiting_user，与 findActiveByOperatorAndUser 一致），blocker 首次真正生效
- notifyMatchmaker TODO 空转 → terminateActiveMatchmakerServices 竞态兜底（残留非终态置 cancelled）；
  不发通知：Phase 18 D2 的 notifications.user_id→users(id) FK 教训
- 守卫 MatchmakerWithdrawBlockerGuardTest 4 用例全绿；首跑暴露测试基建坑：@Transactional Service
  是 CGLIB 代理，ReflectionTestUtils 直调私有方法拿到的是代理实例的 null 字段 → 须先
  AopTestUtils.getTargetObject 解包（已在测试内注释说明）
- 另发现历史遗留：countInProgressByOperator 使用白名单外的 'processing'（已登记）

P04-T10：复核确认 Onboarding 本地资格步骤早已实现（onboarding 消息/动作 + 路由 + /me/status 字段），
JIRA ⏳ → ✅；清除首页语义错位的死状态 isVerified（miniapp tsc EXIT=0）

文档：JIRA 收尾行/计划文档 Task 3.1/3.3 勾选

backend/src/main/java/com/danyang/match/platform/account/service/AccountLifecycleService.java

@@ -85,6 +85,7 @@ public class AccountLifecycleService {
     private final ChatService chatService;
     private final UserIdentityMapper userIdentityMapper;
     private final CounselingFollowupMapper counselingFollowupMapper;
+    private final com.danyang.match.platform.matchmaker.mapper.MatchmakerServiceMapper matchmakerServiceMapper;
 
     // ==================== 退出婚恋服务（暂停推荐） ====================
 
@@ -166,8 +167,9 @@ public class AccountLifecycleService {
 
         Map<String, Object> blockers = new HashMap<>();
 
-        // 检查是否有进行中的红娘服务
-        long activeMatchmakerServices = 0; // 需要 MatchmakerServiceMapper
+        // 检查是否有进行中的红娘服务（2e 接线：原硬编码 0，blocker 从未生效）。
+        // 状态口径 = 生产 chk_matchmaker_status 白名单的非终态值（submitted/assigned/in_service/waiting_user）。
+        long activeMatchmakerServices = matchmakerServiceMapper.countActiveByUserId(userId);
         if (activeMatchmakerServices > 0) {
             blockers.put("matchmakerService", "您有进行中的红娘服务，请先完成或取消");
         }
@@ -270,8 +272,8 @@ public class AccountLifecycleService {
         // 2b. 通知所有活跃 Match 对方
         notifyActiveMatches(user.getId(), "account_closed");
 
-        // 2c. 通知红娘（如果有）
-        notifyMatchmaker(user.getId());
+        // 2c. 终止残留红娘服务（竞态兜底，见方法注释；不能向 operator 发通知——Phase 18 D2 FK 教训）
+        terminateActiveMatchmakerServices(user.getId());
 
         // 2d. 取消所有未开始的活动报名
         cancelPendingActivityRegistrations(userId);
@@ -425,11 +427,34 @@ public class AccountLifecycleService {
     }
 
     /**
-     * 通知红娘服务已终止
+     * 注销收尾（2e 接线，原 {@code notifyMatchmaker} 为 TODO 空转）：把该用户残留的非终态
+     * 红娘服务置为 cancelled。
+     *
+     * <p>正常路径下 {@code checkCanWithdraw} 的 blocker 会要求用户先完成/取消红娘服务，
+     * 走到注销时不应再有非终态记录 —— 本方法是<b>竞态兜底</b>（blocker 检查与注销事务之间，
+     * 红娘管理员恰好受理了新服务）。
+     *
+     * <p><b>为什么不是「发通知」</b>：Phase 18 D2 的教训 —— {@code notifications.user_id → users(id)}
+     * 外键下，operator 不在 users 表，向红娘发用户通知在真实 PG 上必然使注销事务回滚。
+     * 因此以状态收尾 + 日志代替「通知」，效果更实质且不会炸注销事务。
      */
-    private void notifyMatchmaker(String userId) {
-        // TODO: 查询该用户的红娘服务，通知相关红娘
-        log.info("通知红娘服务终止: userId={}", userId);
+    private void terminateActiveMatchmakerServices(String userId) {
+        List<com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord> active =
+                matchmakerServiceMapper.selectList(
+                        new LambdaQueryWrapper<com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord>()
+                                .eq(com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord::getUserId, userId)
+                                .in(com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord::getStatus,
+                                        Constants.MATCHMAKER_STATUS_SUBMITTED,
+                                        Constants.MATCHMAKER_STATUS_ASSIGNED,
+                                        Constants.MATCHMAKER_STATUS_IN_SERVICE,
+                                        Constants.MATCHMAKER_STATUS_WAITING_USER)
+                                .isNull(com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord::getDeletedAt));
+        for (com.danyang.match.platform.matchmaker.entity.MatchmakerServiceRecord svc : active) {
+            svc.setStatus(Constants.MATCHMAKER_STATUS_CANCELLED);
+            svc.setUpdatedAt(Instant.now());
+            matchmakerServiceMapper.updateById(svc);
+            log.info("注销收尾: 残留红娘服务已终止 userId={}, serviceId={}", userId, svc.getId());
+        }
     }
 
     /**

backend/src/main/java/com/danyang/match/platform/matchmaker/mapper/MatchmakerServiceMapper.java

@@ -51,4 +51,14 @@ public interface MatchmakerServiceMapper extends BaseMapper<MatchmakerServiceRec
             "AND deleted_at IS NULL ORDER BY created_at DESC LIMIT 1")
     Optional<MatchmakerServiceRecord> findActiveByOperatorAndUser(@Param("operatorId") String operatorId,
                                                                   @Param("userId") String userId);
+
+    /**
+     * 注销前检查（P16 收尾 2e）：该用户仍处于非终态的红娘服务数。
+     * 状态口径与 {@link #findActiveByOperatorAndUser} 一致（submitted/assigned/in_service/waiting_user）。
+     * ⚠️ 勿用 {@code Constants.MATCHMAKER_STATUS_PENDING} / {@code IN_PROGRESS} ——
+     * 这两个常量不在生产 chk_matchmaker_status 白名单（V009），该表永不出现这两个值。
+     */
+    @Select("SELECT COUNT(*) FROM matchmaker_services WHERE user_id = #{userId} " +
+            "AND status IN ('submitted','assigned','in_service','waiting_user') AND deleted_at IS NULL")
+    long countActiveByUserId(@Param("userId") String userId);
 }