解决在NestJS中使用ollama-js时遇到的ESM模块导入问题

问题背景

在使用NestJS框架集成ollama-js库时，开发者经常会遇到一个典型的模块系统兼容性问题。当尝试通过require()导入ollama时，系统会抛出ERR_REQUIRE_ESM错误，提示不支持直接require ES模块。

错误原因分析

这个问题的根本原因在于模块系统的差异。NestJS默认将TypeScript代码编译为CommonJS格式，而ollama-js库是以ES模块(ESM)格式发布的。CommonJS和ESM是JavaScript的两种不同模块系统，它们在加载机制上有本质区别：

1. CommonJS使用require()/module.exports语法
2. ESM使用import/export语法

当CommonJS环境尝试直接require一个ES模块时，Node.js会抛出ERR_REQUIRE_ESM错误。

解决方案比较

开发者尝试了几种不同的导入方式：

1. 标准ESM导入：直接使用import语法，这在TypeScript开发时可行，但编译后的CommonJS代码仍会出问题
2. 命名导入：尝试导入特定类，同样面临模块系统不兼容
3. 动态导入：使用import()函数，这是Node.js推荐的解决方案

最佳实践方案

对于NestJS项目，推荐以下解决方案：

1. 动态导入方案：这是最符合Node.js官方建议的方式

const ollamaModule = await import('ollama');
const ollama = ollamaModule.default;

2. 配置TypeScript编译目标：修改tsconfig.json，将模块系统目标改为ESNext

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "NodeNext"
  }
}

3. 使用转换工具：通过构建工具(如esbuild)将ESM转换为CommonJS

深入技术细节

理解这个问题的关键在于Node.js的模块加载机制。从Node.js 12开始，逐步支持ES模块，但需要明确声明模块类型：

• 通过package.json中的"type"字段
• 通过文件扩展名(.mjs/.cjs)
• 通过--input-type标志

ollama-js作为ES模块发布，而NestJS传统配置生成CommonJS代码，这种不匹配导致了兼容性问题。

项目维护建议

对于库开发者，可以考虑：

1. 提供双模式分发(ESM+CommonJS)
2. 在文档中明确说明模块类型要求
3. 使用构建工具自动生成多种模块格式

对于应用开发者，了解项目依赖的模块类型并相应配置构建系统是关键。

结论

JavaScript生态正在向ES模块过渡，但过渡期间会出现这类兼容性问题。通过理解模块系统差异和应用适当的解决方案，开发者可以顺利集成ollama-js到NestJS项目中。动态导入是目前最通用的解决方案，而长期来看，将整个项目迁移到ES模块是更可持续的选择。