Node.js+TypeORM开发遭遇MODULE_NOT_FOUND错误求助

一、解决MODULE_NOT_FOUND错误（require导入场景） #

• 检查文件路径准确性
  确认app.js中导入路径为相对根目录的正确路径，例如：

  const User = require('./entity/User');
  

  注意Linux/macOS环境路径大小写敏感，确保代码中文件名与实际文件完全一致（如User.ts≠user.ts）。

• 验证TypeORM实体配置
  确保TypeORM连接配置的entities字段正确指向实体文件：

  const { createConnection } = require("typeorm");
  createConnection({
    type: "mysql",
    host: "localhost",
    port: 3306,
    username: "your-username",
    password: "your-password",
    database: "your-db",
    entities: [__dirname + "/entity/*.ts"], // 或编译后的dist路径
    synchronize: true,
    logging: false
  });
  

  若使用编译后的JS文件，需改为__dirname + "/dist/entity/*.js"，同时确保tsconfig.json配置了正确的outDir。

• 检查tsconfig.json编译配置
  确保tsconfig.json中outDir和rootDir设置正确：

  {
    "compilerOptions": {
      "outDir": "./dist",
      "rootDir": "./",
      "module": "commonjs",
      "target": "es6",
      "esModuleInterop": true
    }
  }
  

  执行tsc编译后，确认dist/entity目录下生成了User.js文件。

二、解决ES模块语法错误（import导入场景） #

• 切换项目为ES模块规范
  在package.json中添加"type": "module"字段：

  {
    "name": "your-project",
    "type": "module",
    "scripts": {
      "start": "node app.js",
      "build": "tsc"
    }
    // 其他依赖配置...
  }
  

  添加后，所有.js文件会被识别为ES模块，需统一使用import语法，require将无法使用。

• 适配TypeORM的ES模块导入
  直接导入实体文件时需添加.js后缀（Node.js ES模块要求），或在连接配置中传入实体类：

  import { createConnection } from "typeorm";
  import User from "./entity/User.js";
  
  createConnection({
    // 数据库连接配置...
    entities: [User]
  });
  

  若使用ormconfig.json，可保持实体路径配置不变，TypeORM会自动处理。

• 调整tsconfig.json适配ES模块
  修改tsconfig.json的模块相关配置：

  {
    "compilerOptions": {
      "module": "ESNext",
      "moduleResolution": "node",
      "outDir": "./dist",
      "rootDir": "./",
      "target": "es6",
      "esModuleInterop": true
    }
  }
  

  编译后的文件会生成ES模块代码，建议使用Node.js v14及以上版本运行。

三、通用排查步骤 #

• 清理依赖并重新安装：rm -rf node_modules && npm install
• 确认TypeORM版本与Node.js版本兼容，优先使用最新稳定版
• 检查文件夹权限，确保Node.js有权限读取entity目录下的文件

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