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 环境下不可解析。应改为：
// 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 依赖此设置）。
✅ 验证与执行流程
-
首次生成迁移（假设数据库为空或已有表结构与当前实体一致）：
npm run migration:generate -- -n InitUserSchema
✅ 成功时将创建 src/database/migrations/xxxxxx-InitUserSchema.ts，含 up/down 方法。
-
运行迁移：
npm run migration:run
后续修改实体后再次生成：
修改字段（如加 @Column() nickname: string;）→ 再次执行 migration:generate → 自动检测差异并生成增量迁移。
? 总结
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| No changes... cannot generate | CLI 无法加载 .ts 实体或数据源 | 使用 typeorm-ts-node-commonjs + 正确 entities glob 路径 |
| 生成空迁移或跳过 | 实体路径未匹配 / 实体未被 import | 检查文件扩展名（.entity.ts）、路径通配符、是否存在语法错误 |
| 迁移运行时报 table not found | migrations 路径指向 src/ 但运行时读取 dist/ | 开发期保持路径为 src/**，构建后部署时再切换为 dist/** |
遵循以上配置，即可稳定实现模块化实体管理下的自动化迁移工作流。
