2.9 KiB
2.9 KiB
role_permission_fk_data_cleanup_plan
更新时间: 2026-03-23
目标: 清理 role/permission 相关孤儿数据,解除 20260323103000-align-role-permission-fk.js 执行阻塞。
1. 审计现状
wms_role_permission.permission_id孤儿记录: 4 条(id: 2, 3, 6, 10)wms_role.store_id非法哨兵值: 3 条(store_id = 0)- 字段类型差异:
wms_permission.id:int(11)wms_role_permission.permission_id:bigint(20) unsigned(迁移已处理为对齐)
2. 执行顺序
- 备份孤儿数据
- 删除
wms_role_permission孤儿行 - 规范
wms_role.store_id = 0为NULL(仅对可空字段) - 复核计数
- 执行迁移
20260323103000-align-role-permission-fk.js
3. 推荐 SQL(先在测试环境执行)
3.1 备份 role_permission 孤儿行
CREATE TABLE IF NOT EXISTS wms_role_permission_orphan_backup_20260323 AS
SELECT rp.*
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL;
3.2 删除 role_permission 孤儿行
DELETE rp
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL;
3.3 规范 role.store_id 哨兵值
UPDATE wms_role
SET store_id = NULL
WHERE store_id = 0;
3.4 复核
SELECT 'rp_perm_orphan' AS metric, COUNT(*) AS cnt
FROM wms_role_permission rp
LEFT JOIN wms_permission p ON p.id = rp.permission_id
WHERE p.id IS NULL
UNION ALL
SELECT 'role_store_zero' AS metric, COUNT(*) AS cnt
FROM wms_role
WHERE store_id = 0;
4. 回滚思路
- 若删除孤儿行后需要回滚,可从备份表恢复:
INSERT INTO wms_role_permission (id, role_id, permission_id, created_at)
SELECT id, role_id, permission_id, created_at
FROM wms_role_permission_orphan_backup_20260323;
wms_role.store_id从0 -> NULL回滚需结合业务语义,不建议盲目全量回写0。
5. 交付门禁
清洗和迁移完成后,执行:
node .\\script\\method-output-regression.cjs comparenode .\\script\\tmp-generate-method-regression-test.cjsnpx egg-bin test temp/generated-tests/system.method-output.generated.test.jsnpx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.info.test.js test/app/controller/home.test.js
通过标准:
- compare: mismatch=0
- 回归测试: 全部通过
6. 执行记录(2026-03-23)
- 备份执行结果:
wms_role_permission_orphan_backup_20260323: 4 行wms_role_store_zero_backup_20260323: 3 行
- 清洗执行结果:
- role_permission 孤儿删除: 4 行
- role.store_id=0 -> NULL: 3 行
- 迁移执行结果:
wms_role_permission.permission_id已对齐为int(11)- 外键
fk_wms_role_permission_permission已生效 - SequelizeMeta 已登记
20260323103000-align-role-permission-fk.js
- 门禁结果:
- method-output compare: mismatch=0
- generated regression + smoke: 14 passing