Nestjs框架: NestJS项目数据库迁移与版本控制实践指南

NestJS项目数据库迁移与版本控制实践指南

一、数据库迁移准备与执行

1. 数据库结构与数据导出

• 在迁移前需完成两阶段准备
• 第一，迁移脚本生成：通过Prisma CLI执行npx prisma migrate dev命令记录当前的数据库状态，系统将提示确认操作（输入y执行或n取消）。此过程会创建迁移记录（如base_v1），并清空数据库原有数据。
• 第二，数据库导出：使用数据库管理工具（如phpMyAdmin）导出完整结构与数据，建议选择gzip + sql格式压缩导出，生成.sql.gz文件。该文件用于后续环境初始化或数据恢复。

2. 迁移版本管理

• 迁移记录命名：首次迁移建议命名为base_v1，明确标注基础权限模块完成状态（含策略、角色、菜单权限完整设计）。
• 迁移链路维护：仅保留必要迁移记录（如basev1），避免冗余版本干扰后续开发。

二、代码版本控制与远程同步

1. 代码提交与标签管理

• 提交规范：执行git commit -m "feat: v1.0 权限控制体系完善"，明确标注版本更新内容。
• 标签创建：通过git tag v1.0.0标记关键版本，配合git push origin --tags同步至远程仓库，支持快速回退或分支创建。

2. 分支策略优化

• 分支与标签协同：若需功能分支开发，可通过git checkout -b feature/branch创建新分支，但建议优先使用标签管理主版本，避免分支冗余。

三、数据恢复与异常处理

1. 数据库恢复流程

• 导入导出文件：使用数据库工具导入.sql.gz文件时，需取消勾选"出错时停止"选项。系统会因表结构冲突报错（如删除/创建表失败），但实际仅需关注数据插入结果。
• 验证恢复效果：检查用户表、权限表等核心数据是否完整，确保测试环境可用性。

2. 脏数据处理策略

• 定期快照机制：开发阶段应养成定期导出数据库的习惯，建议在关键功能模块完成后立即保存状态。
• 数据清理规范：若存在脏数据，需在迁移前通过脚本或工具清理，避免污染迁移基准状态。

四、实践要点总结

1. 迁移与导出协同：Prisma迁移记录代码层变更，数据库导出保存数据层状态，二者结合实现全链路版本控制。
2. Git工作流优化：标签（Tag）与分支（Branch）需按需配合，标签更适合标记稳定版本，分支适用于功能迭代。
3. 数据管理原则：开发环境数据需与生产环境隔离，迁移操作前务必确认数据备份，避免误删风险。

通过上述步骤，可系统化管理NestJS项目数据库状态，为后续业务模块开发提供可靠的技术基线。