-- ============================================================= -- 迁移 V158__notification_subject_user -- -- 1. 变更目的:给 `biz_user_notification` 补一列「这件事是关于哪个用户的」。 -- 这张表从 V116 建表起只有一个用户列 `user_id`,语义是**接收者**(桌面端用户本人 -- 或后台管理员本人),而后台管理员行的主体用户只写在 `content` 文案里 -- ("用户 小魏11(uid=1160)任务 COLLECT_DATA-…")。后果是列表出口拿不到"按用户 -- 聚合"的分组键 ⇒ 铃铛只能一个事件一行地平铺。用户 2026-10-13 反馈 -- 「现在通知的数据都没做整合 看的累」,实测后台侧 217 条未读、22 页, -- 其中同一场景反复出现、只有 uid 与任务号不同(见截图两条「用户采集数据任务部分结果缺失」)。 -- 本迁移是"场景 × 自然日 × 用户"聚合的那一把分组键的存储前提。 -- -- 2. 前提取证(本轮只做代码侧,未跑生产只读普查): -- · V116 建表语句里与用户相关的列只有 `user_id BIGINT NOT NULL COMMENT '接收者ID'` -- 与 `audience`(user=桌面端/admin=后台),没有主体用户列; -- · 写入侧本来就知道主体是谁:`NotificationDispatchService.pushToAdmins(..., subjectUserId)` -- 的第 62 行已经拿它做 `audience.canReceive(adminId, subjectUserId)` 的数据权限过滤, -- 只是过滤完就把这个值丢了、没有落库 ⇒ 补列不需要新的推导逻辑; -- · 全仓 `notificationService.push/pushOrRefresh` 的调用点共 6 处,全部在通知模块内 -- (NotificationDispatchService 5 处 + NotificationScanScheduler 1 处), -- 没有模块外的写入方需要一起改。 -- -- 3. 影响表与数据量:只加一列,不写数据、不加索引、不删列、不碰其他表。 -- 存量行取 NULL。口径(用户 2026-10-13 定):**存量不回填**——旧的管理员行不按用户 -- 拆开,聚合时所有 NULL 归为同一组,界面上表现为「未区分用户」的一组,展开仍能看到明细。 -- 不做回填的理由是不拿正则去解析历史文案当分组键(措辞改过形的行会静默漏归, -- 而"漏归"在界面上与"本来就没有"同形)。 -- `audience='user'` 的行由写入侧自动补成 `subject_user_id = user_id`(同一人), -- 所以桌面端不需要回填也有分组键。 -- -- 4. 锁表风险:极低。nullable、无 DEFAULT 的 `ADD COLUMN` 在 MySQL 8 走 INSTANT, -- 不重建表、不阻塞 DML。**刻意不加二级索引**:聚合查询的过滤条件恒为 -- `user_id = ? AND audience = ?`,V116 的 `idx_user_audience_read` 已覆盖这对等值前缀, -- 组内行数又被 `NotificationRetentionService` 的 7 天物理保留压住 ⇒ 加 (audience, user_id, -- scene, created_at, subject_user_id) 这种宽索引买不到东西,只多一次重建表。 -- -- 5. 验证 SQL(迁移后跑,不许只看启动日志的 Successfully applied): -- SHOW COLUMNS FROM `biz_user_notification` LIKE 'subject_user_id'; -- -> 期望 1 行:Type = bigint,Null = YES,Default = NULL -- SELECT COUNT(*) AS total, -- SUM(subject_user_id IS NULL) AS unlabelled -- FROM `biz_user_notification`; -- -> 期望 unlabelled = total(本迁移只加列,不回填) -- SHOW INDEX FROM `biz_user_notification`; -- -> 期望索引清单与迁移前逐字相同(没有新增索引) -- 迁移后新产生的行:`SELECT id, audience, user_id, subject_user_id, scene -- FROM biz_user_notification ORDER BY id DESC LIMIT 10;` -- -> audience='user' 的行 subject_user_id 应等于 user_id; -- audience='admin' 的行 subject_user_id 应是文案里那个 uid(跨用户合并的 -- pushToAdminsAnyOf 除外,那类事件主体不唯一,留 NULL)。 -- -- 6. 上线窗口:随 jar 双节点同窗口发布。加列对旧 jar 无影响(旧代码不认识新列, -- MyBatis-Plus 按实体字段生成列名,旧实体没有这一列 ⇒ INSERT 里不会出现它); -- 反过来只发 jar 不发迁移,会在第一次写 subject_user_id 时撞 1054 Unknown column。 -- ⇒ 迁移必须与读它的那版 jar 同版。 -- -- 7. 可重跑性:照 V146/V155/V157 惯例,加列前先查 information_schema——迁移中途失败时 -- flyway repair + 重启会从第一条语句重跑整个文件,裸 ADD COLUMN 会撞 1060。 -- -- 8. 回滚(人工补丁,写成注释以免落在 Flyway 扫描路径里被当迁移执行): -- 触发场景是"这一列不该加"。顺序:停两台应用 → 跑下面一条 DROP → -- 删 flyway_schema_history 的 version='158' 行 → 回滚 jar → 起应用。 -- ALTER TABLE `biz_user_notification` DROP COLUMN `subject_user_id`; -- 仅回滚 jar(代码问题、与列无关)不需要 DROP:旧 jar 不认识这一列,留着零影响。 -- 注意:新 jar 跑过之后这一列会积累非 NULL 值,DROP 会连带丢掉"按用户分组"的依据, -- 使聚合退回"未区分用户"那一组——那是显示退化,不是数据丢失(明细行本身还在)。 -- ============================================================= SET @tbl := ( SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'biz_user_notification' AND COLUMN_NAME = 'subject_user_id' ); SET @ddl := IF(@tbl = 0, 'ALTER TABLE `biz_user_notification` ADD COLUMN `subject_user_id` bigint NULL DEFAULT NULL COMMENT ''事件主体用户(users.id):管理员行=这件事关于谁,桌面端行=user_id 本人;NULL=存量未标注或主体不唯一''', 'SELECT ''biz_user_notification.subject_user_id already exists, skipped'' AS note'); PREPARE stmt FROM @ddl; EXECUTE stmt; DEALLOCATE PREPARE stmt;