如何让Parse Server（v6.4.0）识别Node.js项目已切换为ESM？

核心原因 #

Parse Server的ESM分支判断逻辑依赖npm提供的npm_package_type环境变量，当直接用node app.js启动时，该变量不会自动设置，导致Parse Server仍使用require()加载你的ESM文件，从而触发报错。

具体解决方案 #

1. 使用npm启动脚本替代直接node启动 #

在项目根目录的package.json中添加启动脚本：

{
  "scripts": {
    "start": "node app.js"
  },
  "type": "module"
}

之后通过npm start命令启动服务器，npm会自动将npm_package_type环境变量设置为module，Parse Server就能识别当前处于ESM环境，自动切换到动态import()逻辑加载你的文件。

2. 确保文件与配置的ESM兼容性 #

• 确认项目根目录的package.json顶层存在"type": "module"字段，不要嵌套在其他配置项中。
• 所有自定义代码文件统一使用import/export语法，避免混合require()调用。
• 如果云代码文件（如main.js）不在项目根目录，需在该文件所在子目录添加单独的package.json并设置"type": "module"。

3. 修改文件扩展名（备选方案） #

如果上述方法无效，可将你的ESM文件扩展名改为.mjs（如main.mjs），并更新Parse Server配置中对应的文件路径：

import ParseServer from 'parse-server';

const parseServer = new ParseServer({
  // 其他配置项
  cloud: './main.mjs'
});

Node.js会强制将.mjs文件视为ESM，Parse Server加载时会自动使用动态import()而非require()。

4. 检查版本兼容性 #

确认Parse Server 6.4.0的ESM支持情况，该版本属于较新分支，理论上已兼容ESM，但如果问题仍存在，可尝试升级到最新稳定版，修复可能存在的识别bug。

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