fix(通道流量阈值): AUG26-011 修复周期处理连接池自锁并补齐根池句柄验证与文档

internal/application/carrierthreshold/cycle.go

@@ -124,6 +124,8 @@ func (s *Service) processDueLock(ctx context.Context, item *DueLock, stats *Cycl
 // 只解锁不写复机事件、不调运营商：配置缺失时无法判断是否已跨期，解除通道锁交由既有复机链路
 // 与人工决定；anomaly_flag 与失败原因使运维可见并转人工核对。解锁与异常标记都是条件更新，
 // 重复执行不会产生第二次副作用。
+// 两者 MUST 共用同一个事务句柄：解锁已持有该行锁，若异常标记改走服务自身连接池，另一条连接
+// 会等待本事务的行锁（自锁），处理将挂死到语句超时并使该 cron 每分钟空转。
 func (s *Service) processUnresolvableLock(ctx context.Context, item *DueLock, stats *CycleStats) error {
 	lock := &item.Lock
 	s.logger.Warn("通道阈值锁行周期归属不可判定，解锁并转人工核对",
@@ -139,7 +141,7 @@ func (s *Service) processUnresolvableLock(ctx context.Context, item *DueLock, st
 			return nil
 		}
 		unlocked = true
-		_, anomalyErr := s.markAnomaly(ctx, lock.ID, item.Reason)
+		_, anomalyErr := s.markAnomalyInTx(ctx, tx, lock.ID, item.Reason)
 		return anomalyErr
 	})
 	if err != nil {

internal/application/carrierthreshold/lock_store.go

@@ -297,13 +297,25 @@ func (s *Service) markTaskConfirmed(ctx context.Context, lockID uint, task lockT
 	return s.markTaskOutcome(ctx, lockID, task, domain.UnresolvedTaskStatuses(), domain.TaskStatusConfirmed, integrationID, "")
 }
 
-// markAnomaly 把锁标记为需人工核对并退出自动扫描。
+// markAnomaly 把锁标记为需人工核对并退出自动扫描（使用服务自身连接池，调用方不得已持有该行锁）。
 // 只应在窗口超期且结果无法确认时调用；已标记的锁不再重复查询。
 func (s *Service) markAnomaly(ctx context.Context, lockID uint, reason string) (bool, error) {
-	if s == nil || s.db == nil || lockID == 0 {
+	if s == nil || s.db == nil {
 		return false, nil
 	}
-	result := s.db.WithContext(ctx).Model(&model.CarrierTrafficThresholdLock{}).
+	return s.markAnomalyInTx(ctx, s.db, lockID, reason)
+}
+
+// markAnomalyInTx 在调用方事务内把锁标记为需人工核对（anomaly_flag=0 → 1 条件更新）。
+//
+// 调用方已在同一事务内写过该行时 MUST 使用本方法：改用服务自身连接池会让另一条连接
+// 等待本事务持有的行锁（自锁），表现为处理挂死到语句超时。返回 false 表示已被并发标记，
+// 调用方按幂等处理。
+func (s *Service) markAnomalyInTx(ctx context.Context, tx *gorm.DB, lockID uint, reason string) (bool, error) {
+	if tx == nil || lockID == 0 {
+		return false, nil
+	}
+	result := tx.WithContext(ctx).Model(&model.CarrierTrafficThresholdLock{}).
 		Where("id = ? AND anomaly_flag = ?", lockID, domain.AnomalyFlagNone).
 		Updates(map[string]any{
 			"anomaly_flag":   domain.AnomalyFlagManual,