执行yarn db:migrate报错：Cannot find module './typeorm'求解决

先定位问题根源 #

这个错误本质是模块路径解析失败，要么是TypeORM配置文件里的导入路径写错了，要么是Yarn 3的PnP模式和ts-node/TypeORM的兼容问题，再或者是TypeORM版本升级后API变更导致的。

一步步修复 #

1. 检查TypeORM配置的导入路径 #

找项目里的ormconfig.ts或者data-source.ts（TypeORM 0.3+版本用这个），看看有没有import './typeorm'这类代码：

• 如果./typeorm文件根本不存在，直接删掉这行导入，或者改成正确的路径（比如导入你的DataSource实例文件）。
• 如果是你升级了TypeORM到0.3+版本，旧样板用的是0.2.x的ormconfig格式，0.3+已改用DataSource类，得把配置改成新格式，示例：

  // src/data-source.ts
  import { DataSource } from "typeorm";
  
  export const AppDataSource = new DataSource({
    type: "postgres",
    host: "localhost",
    port: 5432,
    username: "postgres",
    password: "postgres",
    database: "your_db_name",
    synchronize: false,
    logging: false,
    entities: ["src/entities/**/*.ts"],
    migrations: ["src/migrations/**/*.ts"],
    subscribers: [],
  });
  

2. 适配Yarn 3的模块解析 #

Yarn 3默认的PnP模式对很多老工具支持不佳，直接切回传统node_modules模式最省心：

• 在项目根目录新建/修改.yarnrc.yml，添加一行：

  nodeLinker: node-modules
  

• 删除node_modules和.yarn/cache目录，重新执行yarn install刷新依赖。

3. 修正ts-node的配置 #

让ts-node能正确识别TypeScript路径和TypeORM模块：

• 安装依赖：yarn add -D tsconfig-paths
• 在tsconfig.json中添加ts-node配置：

  {
    "ts-node": {
      "require": ["tsconfig-paths/register"]
    },
    "compilerOptions": {
      "baseUrl": "./",
      "paths": {
        "@/*": ["src/*"] // 如果项目用了路径别名，确保此处配置正确
      }
    }
  }
  

4. 修正db:migrate命令格式 #

TypeORM 0.3+版本的命令格式已变更，原命令未指定DataSource会报错：

• 修改package.json中的scripts：

  "scripts": {
    "db:migrate": "ts-node ./node_modules/typeorm/cli.js migration:generate -d ./src/data-source.ts src/migrations/InitialSetup",
    "db:run": "ts-node ./node_modules/typeorm/cli.js migration:run -d ./src/data-source.ts"
  }
  

  其中-d用于指定你的DataSource配置文件路径，后面是迁移文件的输出位置和名称。

5. 确认PostgreSQL连接正常 #

别光顾着代码，先排查数据库状态：

• 执行docker-compose ps查看PostgreSQL容器是否正常运行。
• 检查data-source.ts中的连接配置：host、端口、用户名、密码、数据库名必须和docker-compose.yml中的配置一致（比如host如果用容器名，要确保本地能解析，或者直接用localhost，前提是docker已映射5432端口）。

6. 重新执行迁移操作 #

先执行yarn db:migrate生成迁移文件，再执行yarn db:run将迁移应用到数据库，数据即可正常填充。

避坑提醒 #

• 不要盲目升级依赖！这个样板可能基于TypeORM 0.2.x开发，升级到0.3.x会有大量API变化，建议先锁定样板原本的依赖版本，跑通后再逐步升级。
• 如果非要使用Yarn 3的PnP模式，需确保ts-node和TypeORM都支持PnP，比如安装@yarnpkg/pnpify包装命令，但不如切回node_modules模式省心。

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