NodeJS省略.js后缀或导入目录默认index.js时模块找不到问题排查

核心原因：Node.js ES模块的严格导入规则 #

你的项目server/package.json中设置了"type": "module"，这意味着所有.js文件都以ES模块规范执行。Node.js对ES模块的导入规则和CommonJS有明显区别，这是导致问题的根本原因——和代码本身、Babel/ESLint无关（ESLint仅做语法检查，不影响运行时模块解析）。

两种场景的具体解释 #

1. 省略.js后缀找不到模块
   ECMAScript标准中没有自动补全文件后缀的规则，Node.js作为ES模块的实现，严格遵循这一标准：必须显式指定.js、.mjs等文件后缀才能正确解析模块路径，这和CommonJS允许省略后缀的行为完全不同。

2. 导入目录无法默认加载index.js
   在ES模块规范下，导入目录时不会自动查找目录下的index.js。要让目录导入生效，必须满足两个条件之一：

• 显式指定目录下的入口文件，比如import { Inventory } from '../../models/index.js'
• 在目标目录下添加package.json，通过main字段指定入口文件

可行解决方案 #

方案1：保持显式路径（已验证有效）

继续使用带完整后缀的导入路径，这是最稳妥、符合标准的做法：

import { Inventory } from '../index.js';
import Inventory from '../../models/Inventory/Inventory.model.js';

方案2：给目录添加package.json配置

在/models目录下创建package.json文件，内容如下：

{
  "main": "index.js"
}

此时import { Inventory } from '../../models'就能正常解析到models/index.js。

方案3：使用实验性特性（不推荐生产环境）

如果想模拟CommonJS的路径解析行为，可以启用Node.js的实验性参数--experimental-specifier-resolution=node，修改server/package.json的scripts：

"scripts": {
  "watch": "nodemon --experimental-specifier-resolution=node",
  "seed": "node --experimental-specifier-resolution=node config/seeds.js"
}

注意：该特性属于实验性，未来可能发生变化，生产环境不建议依赖。

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