Răsfoiți Sursa

fix(migrations): 修复迁移492能量幂等键与迁移484 openid唯一索引

迁移492 energy_log 幂等键:
- 根因:streak每日打卡source_id恒为0,原唯一键无日期维度导致跨日合法记录互相冲突;
  存量同日双发重复400行666分
- 修复:新增stat_date STORED生成列DATE(created_at),唯一键改为
  (child,dim,type,source_id,stat_date)五列;schema.sql同步
- 数据手术:删400条同日重复(保留MIN(id))+回冲energy_balance按各child/dim聚合
  +按(created_at,id)重算balance_after链
- 验证:541行 sum2191 链断点0 balance一致性mismatch0 重复0 stat_date全填充

迁移484 users openid唯一索引:
- 根因:双胞胎用户16/17同openid + 空openid三户96/107/108同appid导致索引建不上
- 修复:用户17及空openid三户openid改唯一占位符(均无微信登录能力,无业务影响)
  +建(openid,appid)唯一索引成功

幂等日志:492/484 catch区分Duplicate key name(已存在INFO)与Duplicate entry(数据重复WARN)

部署回执:备份cfc_backup_20261118_090220.tar.gz + 专项表备份 + jar替换 + systemctl重启
+ API 3接口200 + ERROR0 + 两唯一索引/数据一致性终态验证通过
Xiaogang Liao 18 ore în urmă
părinte
comite
3b418b8f7d

+ 16 - 7
cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java

@@ -3944,15 +3944,23 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
 
         // 迁移492: 五维能量账本一致性守卫落地(energy.ledger.guard,S-cfc-390 · SC-X-20/21)
         //   a) energy_balance 补 version 列(MyBatis-Plus @Version 乐观锁,并发原子加防丢失更新)
-        //   b) energy_log 补 (child_id, dimension_id, source_type, source_id) 幂等唯一键
-        //      (同源重复回调/网络重试不重复入账;存量库中存在重复数据时该键建不成功则告警,不报错中断)
+        //   b) energy_log 补幂等唯一键(同源重复回调/网络重试不重复入账)
+        //      ——键含日期维度:streak 每日打卡 source_id 恒为 0,若无日期则跨日合法记录互相冲突。
+        //      stat_date 为 STORED 生成列 DATE(created_at)(MySQL 8.0 不支持函数索引,故用生成列承载)。
         ensureColumn("energy_balance", "version", "INT DEFAULT 0 COMMENT '乐观锁版本号(并发原子加防丢失更新,SC-X-21)'");
+        ensureColumn("energy_log", "stat_date",
+                "DATE GENERATED ALWAYS AS (DATE(created_at)) STORED COMMENT '入账日期(幂等键日期维度,SC-X-21)'");
         try {
             jdbcTemplate.execute("ALTER TABLE energy_log ADD UNIQUE KEY uk_energy_idempotency "
-                    + "(child_id, dimension_id, source_type, source_id)");
-            log.info("迁移492: energy_log 幂等唯一键 uk_energy_idempotency 已添加");
+                    + "(child_id, dimension_id, source_type, source_id, stat_date)");
+            log.info("迁移492: energy_log 幂等唯一键 uk_energy_idempotency 已添加(含 stat_date 日期维度)");
         } catch (Exception e) {
-            log.warn("迁移492: energy_log 幂等唯一键添加失败(可能已存在或存量数据含重复,需人工清理): {}", e.getMessage());
+            String msg = e.getMessage();
+            if (msg != null && msg.contains("Duplicate key name")) {
+                log.info("迁移492: energy_log 幂等唯一键 uk_energy_idempotency 已存在,跳过");
+            } else {
+                log.warn("迁移492: energy_log 幂等唯一键添加失败(存量数据含重复,需人工清理): {}", msg);
+            }
         }
     }
 
@@ -4056,8 +4064,9 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
             log.info("迁移484: users.uk_openid_appid 唯一索引创建成功");
         } catch (Exception e) {
             String msg = e.getMessage();
-            if (msg != null && (msg.contains("Duplicate") || msg.contains("already exists")
-                    || msg.toLowerCase().contains("duplicate"))) {
+            if (msg != null && (msg.contains("Duplicate key name") || msg.contains("already exists"))) {
+                log.info("迁移484: users.uk_openid_appid 唯一索引已存在,跳过");
+            } else if (msg != null && msg.toLowerCase().contains("duplicate")) {
                 log.warn("迁移484: users.uk_openid_appid 唯一索引建失败(存在同 appid 内重复 openid,请人工处理): {}", msg);
             } else {
                 // 其他未知错误,仅 warn 保留应用启动能力;后续可重试迁移

+ 4 - 2
cfc-backend/src/main/resources/schema.sql

@@ -1616,11 +1616,13 @@ CREATE TABLE IF NOT EXISTS energy_log (
     expires_at DATETIME COMMENT '过期时间(空=永不过期)',
     description TEXT COMMENT '描述',
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    stat_date DATE GENERATED ALWAYS AS (DATE(created_at)) STORED COMMENT '入账日期(幂等键日期维度,SC-X-21)',
     INDEX idx_child_dim (child_id, dimension_id),
     INDEX idx_created (created_at),
     INDEX idx_source (source_type, source_id),
-    -- SC-X-21 幂等不重复加:同 member+dimension+sourceType+sourceId 唯一,重复回调/网络重试不重复入账(energy.ledger.guard)
-    UNIQUE KEY uk_energy_idempotency (child_id, dimension_id, source_type, source_id)
+    -- SC-X-21 幂等不重复加:同 member+dimension+sourceType+sourceId+当日 唯一;
+    -- stat_date 日期维度保证 streak 每日打卡(source_id 恒为 0)跨日合法、仅同日重复回调被拦
+    UNIQUE KEY uk_energy_idempotency (child_id, dimension_id, source_type, source_id, stat_date)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量流水表';
 
 -- 维度余额表