如何在TypeORM中通过迁移为现有表添加新列？执行遇问题求助

一、解决"cannot use import statement outside a module"错误 #

这个问题本质是TypeORM执行了未编译的TypeScript文件，或者配置指向了错误的文件路径/模块格式，按以下步骤排查：

• 确认迁移路径指向编译后的JS文件：检查你的数据源配置文件（如data-source.ts），确保migrations字段指向dist/migrations/**/*.js，而非src/migrations下的TS文件。例如：

  export const AppDataSource = new DataSource({
    // 其他配置
    migrations: ['dist/migrations/**/*.js'],
  });
  

• 执行迁移时指定编译后的数据源文件：生产环境下必须用编译后的JS文件启动迁移，命令应为：

  npx typeorm migration:run -d dist/data-source.js
  

• 检查package.json模块类型：如果你的项目编译后输出CommonJS格式，确保package.json的type字段不要设为module（或在数据源文件中改用CommonJS导出，如module.exports = AppDataSource）。

二、解决"无待处理迁移"问题 #

已执行npm run build但仍无待处理迁移，按以下方向排查：

• 检查迁移文件名格式：TypeORM迁移文件必须以时间戳前缀开头（如1700123456789-AddNewColumnToTable.ts）。如果手动修改过文件名或创建时未生成时间戳，TypeORM会无法识别为新迁移。
• 查看数据库迁移记录表：登录数据库，查看默认名为typeorm_migrations的表，确认你的新迁移文件名是否已存在于表中。如果存在，说明该迁移已被执行过，可选择：
  • 若未实际生效，删除表中对应记录后重新执行迁移（生产环境需先备份数据库）；
  • 若需重新执行，创建新的迁移文件而非修改旧文件。
• 验证编译结果：检查dist/migrations目录下是否存在对应迁移文件的JS版本，且代码正确（比如queryRunner.addColumn的逻辑是否被正确编译）。若编译未生成文件，检查tsconfig.json是否包含migrations目录的编译规则。
• 指定正确的配置文件：执行迁移时必须明确指定数据源文件路径，避免TypeORM加载默认配置导致找不到迁移文件。

注意事项 #

• 每次创建新迁移后，必须重新执行npm run build，确保迁移文件被编译到生产目录；
• 生产环境操作迁移前，务必备份数据库，避免数据丢失；
• 若使用TypeORM 0.3.x+版本，必须使用data-source.ts的配置方式，旧版ormconfig已被废弃。

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