mongoose 8.4.4与Angular 18 SSR（Node）兼容性故障求助

核心原因 #

Angular 18 SSR构建后的服务端代码是ESM模块（.mjs），而require('mongoose')是CommonJS的导入语法，在ESM环境中混用会导致模块加载异常，触发Cannot convert undefined or null to object这类底层错误。

具体修复步骤 #

1. 替换CommonJS导入为ESM语法
   把const mongoose = require('mongoose');改成：

   import mongoose from 'mongoose';
   

   同时确认项目package.json中存在"type": "module"字段（Angular 18默认SSR配置已自动添加），保证服务端代码以ESM规范加载。

2. 调整Mongoose初始化时机
   避免在模块顶级作用域过早初始化Mongoose，将数据库连接逻辑放在Angular SSR服务启动之后执行，比如：

   async function bootstrap() {
     const app = await bootstrapApplication(AppServerModule, {
       providers: [provideServerRendering()]
     });
     // 先启动Angular SSR服务
     await app.listen(process.env.PORT || 4000);
     // 再初始化Mongoose连接
     await mongoose.connect('你的数据库连接字符串');
   }
   bootstrap();
   

3. 验证依赖兼容性
   Angular 18的ESM环境对旧版CommonJS模块兼容性有限，建议使用原生支持ESM的Mongoose版本（8.x系列本身支持ESM），同时执行npm update更新所有依赖，确保@angular/platform-server等核心包为18.x版本。

4. 清理构建缓存
   清理旧构建产物后重新构建，避免残留的CommonJS代码冲突：

   ng clean && ng build
   

额外排查点 #

• 若自定义了webpack配置，检查是否强制将Mongoose转换为CommonJS模块
• 确认数据库连接字符串格式正确，排除连接失败导致的间接错误

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