NestJs集成TypeORM执行迁移未更新数据库问题求助

根因说明 #

你执行的npm run migrate:create Init命令本身就不会自动生成实体对应的变更内容，这个脚本的作用仅为生成一个带时间戳命名的空迁移骨架文件，你看到的成功提示仅代表空文件创建完成，不会同步实体结构、也不会对数据库做任何修改。

synchronize: true是TypeORM提供的开发阶段快速同步配置，开启后会绕过迁移机制直接在应用启动时对比实体修改表结构，这个机制不会生成迁移记录，也不适合在正式环境使用。

排查解决步骤 #

• 先区分迁移相关命令的作用
  该样板默认配置中，migrate:create仅用于手动创建空迁移，需要自己编写up/down逻辑；自动对比实体与当前数据库结构差异、生成对应变更SQL的命令是npm run migration:generate <迁移名称>，之前用错命令是核心问题。
• 检查生成迁移前的配置项
  执行自动生成命令前必须确认以下配置正确：
  1. 本地数据库服务正常运行，TypeORM数据源配置的连接地址、账号、库名和你实际使用的数据库完全对应
  2. 数据源配置中的entities匹配规则覆盖了所有业务实体文件，包括你新增的实体，不要漏写路径glob规则
  3. 必须将synchronize配置设为false：该配置为true时TypeORM会直接自动同步表结构，迁移对比时会读不到差异，生产环境开启还存在数据丢失风险
  4. 数据源配置中的migrations路径和你本地实际存放迁移文件的目录完全一致
• 按正确流程执行迁移
  1. 新增/修改实体后，先停掉本地正在运行的Nest应用，释放数据库连接
  2. 执行npm run migration:generate Init，执行完成后打开对应时间戳的迁移文件，确认文件内已经生成了对应的建表/改字段的SQL逻辑，不是空内容
  3. 执行npm run migration:run应用迁移，执行完成后可以检查数据库：一方面业务表结构会完成更新，另一方面库中自带的migrations表会新增本次迁移的执行记录
• 生成空文件的特殊场景排查
  如果执行migration:generate后依然得到空内容的迁移文件，逐一核对以下问题：
  1. 新增/修改的实体已经在对应业务模块的TypeORM配置中正确注册，能被应用正常识别
  2. 实体文件中的装饰器写法没有语法错误，字段定义能被TypeORM正确解析
  3. 当前连接的数据库表结构已经和实体定义完全一致，本身不存在需要同步的差异

注意：synchronize: true仅适合本地快速写原型的时候临时使用，所有正式环境的表结构变更必须通过迁移文件执行，保证结构变更可追溯、可回滚，避免出现数据误删、结构不一致的问题。

内容的提问来源于stack exchange，提问作者Vladimir Petukhov