# 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. 执行顺序 1. 备份孤儿数据 2. 删除 `wms_role_permission` 孤儿行 3. 规范 `wms_role.store_id = 0` 为 `NULL`(仅对可空字段) 4. 复核计数 5. 执行迁移 `20260323103000-align-role-permission-fk.js` ## 3. 推荐 SQL(先在测试环境执行) ### 3.1 备份 role_permission 孤儿行 ```sql 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 孤儿行 ```sql 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 哨兵值 ```sql UPDATE wms_role SET store_id = NULL WHERE store_id = 0; ``` ### 3.4 复核 ```sql 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. 回滚思路 - 若删除孤儿行后需要回滚,可从备份表恢复: ```sql 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. 交付门禁 清洗和迁移完成后,执行: 1. `node .\\script\\method-output-regression.cjs compare` 2. `node .\\script\\tmp-generate-method-regression-test.cjs` 3. `npx egg-bin test temp/generated-tests/system.method-output.generated.test.js` 4. `npx 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