TypeORM 迁移生成失败的常见原因与解决方案

typeorm `migration:generate` 无法生成迁移文件，通常是因为实体未被正确识别或配置不匹配；本文详解如何通过修正实体装饰器、调整数据源配置及使用兼容工具链（如 `typeorm-ts-node-commonjs`）来可靠生成并运行迁移。

在 NestJS + TypeORM 项目中，typeorm migration:generate 报错 “No changes in database schema were found” 是高频问题。其根本原因并非数据库无变更，而是 TypeORM CLI 在执行时未能正确加载或解析你的 TypeScript 实体类 —— 尤其当实体位于 src/modules/**/entities/ 深层路径下，且使用 .ts 扩展名时，原生 typeorm CLI（基于 JavaScript 运行时）默认无法直接处理未编译的 TS 文件。

✅ 正确做法：使用 typeorm-ts-node-commonjs

原生 typeorm CLI 不支持直接读取 .ts 数据源文件（如 config/typeorm.ts），需借助兼容层：

npm install --save-dev typeorm-ts-node-commonjs

安装后，更新 package.json 中的脚本（移除 ts-node 手动调用，改用封装好的命令）：

"scripts": {
  "migration:generate": "npx typeorm-ts-node-commonjs migration:generate ./src/database/migrations -d config/typeorm.ts",
  "migration:run": "npx typeorm-ts-node-commonjs migration:run -d config/typeorm.ts",
  "migration:revert": "npx typeorm-ts-node-commonjs migration:revert -d config/typeorm.ts"
}

? 注意：-d config/typeorm.ts 必须指向导出 DataSourceOptions 的 TS 配置文件（你已正确配置为 config/typeorm.ts），而非 JS 编译产物。

✅ 实体定义无需 synchronize: true

答案中提到的 @Entity({ synchronize: true }) 是误导性方案，且不应采用：

• synchronize: true 仅用于开发环境自动同步表结构（绕过迁移机制），与 migration:generate 逻辑无关；
• 在生产环境中启用该选项极危险，会导致数据丢失；
• TypeORM 迁移系统完全依赖 entities 路径配置 + 实体类是否被实际 import/注册，而非该装饰器参数。

请确保你的实体定义简洁规范，例如：

// src/modules/user/entities/user.entity.ts
import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';

@Entity('users') // ✅ 仅需标准装饰器
export class User {
  @PrimaryGeneratedColumn('uuid')
  id: string;

  @Column({ unique: true })
  email: string;
}

✅ 数据源配置关键点

你的 config/typeorm.ts 中 entities 路径为：

entities: ['./dist/src/modules/**/entities/*.ts'],

⚠️ 这是错误的——CLI 运行时在开发阶段（未 build）无法访问 ./dist/，且 .ts 后缀在 JS 环境下不可解析。应改为：

Hama

AI图片对象智能抹除

下载

// config/typeorm.ts（开发环境专用配置）
entities: ['src/modules/**/entities/*.entity.{ts,js}'],
migrations: ['src/database/migrations/*{.ts,.js}'],

同时，确保 tsconfig.json 中 compilerOptions.module 为 "commonjs"（typeorm-ts-node-commonjs 依赖此设置）。

✅ 验证与执行流程

1. 首次生成迁移（假设数据库为空或已有表结构与当前实体一致）：

   npm run migration:generate -- -n InitUserSchema

   ✅ 成功时将创建 src/database/migrations/xxxxxx-InitUserSchema.ts，含 up/down 方法。

2. 运行迁移：

   npm run migration:run

3. 后续修改实体后再次生成：
   修改字段（如加 @Column() nickname: string;）→ 再次执行 migration:generate → 自动检测差异并生成增量迁移。

? 总结

遵循以上配置，即可稳定实现模块化实体管理下的自动化迁移工作流。