Node.js+TypeScript中tsc编译import异常导致TypeORM迁移失败

编译后文件首行被注释的import语句是TypeScript编译时自动生成的源码提示注释，不是编译错误，实际依赖已经被转换为CommonJS的require语法正常导入，真正导致TypeORM迁移失败的是3处配置冲突：

• 模块系统冲突：package.json中声明了"type": "module"，强制Node.js将所有.js文件识别为ES Module格式，但tsconfig.json配置的module: "commonjs"，编译输出的是CommonJS规范代码，模块解析逻辑完全不兼容
• TypeORM配置错误：ormconfig.json中cli.entitiesDir路径写为src/entities，和实际实体目录app/entities不匹配；同时entities仅配置了TS源码路径，编译后运行时找不到JS格式的实体文件
• 脚本命令错误：自定义的typeorm脚本已经配置了ts-node启动，但后续迁移相关脚本直接调用原生typeorm命令，不会自动编译TS文件；且脚本中使用的-d参数是TypeORM 0.3.x版本的数据源参数，你当前安装的0.2.x版本不支持该参数，会导致配置读取失败

1. 解决模块系统冲突 #

推荐选择和现有tsconfig匹配的CommonJS方案，直接删除package.json中的"type": "module"字段即可，Node.js会默认将编译输出的.js文件识别为CommonJS格式，无需修改其他编译配置。
如果需要保留ES Module规范，可将tsconfig.json中module改为"ESNext"、moduleResolution改为"node16"，注意后续所有相对路径导入需要补充.js后缀。

2. 修正ormconfig.json配置 #

调整实体、迁移路径兼容开发和编译后运行场景，修正cli目录配置，关闭危险的自动表同步：

{
  "type": "mysql",
  "host": "localhost",
  "port": 3306,
  "username": "root",
  "password": "test",
  "database": "test",
  "migrationsTableName": "migrations",
  "entities": ["app/entities/*.ts", "lib/entities/*.js"],
  "migrations": ["migration/*.ts", "migration/*.js"],
  "cli": {
    "entitiesDir": "app/entities",
    "migrationsDir": "migration"
  },
  "autoSchemaSync": false
}

注意：autoSchemaSync在生产环境会直接修改表结构，极易造成数据丢失，正式项目必须用迁移功能替代该配置。

3. 修正package.json脚本 #

所有TypeORM相关命令统一走带ts-node的别名，修正编译命令和0.2版本适配的配置参数：

{
  "scripts": {
    "typeorm": "ts-node ./node_modules/typeorm/cli.js -f ormconfig.json",
    "build": "rm -rf lib && tsc",
    "server": "npm run build && node lib/server.js",
    "db:sync": "npm run typeorm schema:sync",
    "db:migrate:generate": "npm run typeorm migration:generate -n",
    "db:migrate:revert": "npm run typeorm migration:revert",
    "db:migrate:run": "npm run typeorm migration:run"
  }
}

4. 功能验证 #

1. 执行npm run build，清空旧编译产物重新生成，无需处理编译后JS文件首行被注释的import语句，该注释不影响代码运行
2. 执行npm run db:migrate:generate TestInit，确认migration目录下正常生成迁移文件
3. 执行npm run db:migrate:run，确认数据库中用户表、迁移记录表正常创建即可

内容的提问来源于stack exchange，提问作者garden lee