Node.js+Express+MongoDB ES模块写入数据库失败排查求助

1. 确认ES模块模式已启用 #

在package.json中必须添加"type": "module"，否则Node会默认按CommonJS解析文件，导致导入导出逻辑混乱：

{
  "name": "your-project",
  "type": "module",
  // 其他配置项...
}

2. 修正MongoDB模型的导出/导入方式 #

CommonJS与ES模块写法对比 #

• CommonJS模型导出：

// models/Post.js
const mongoose = require('mongoose');
const schema = new mongoose.Schema({ title: String, content: String });
module.exports = mongoose.model('Post', schema);

• ES模块模型导出（必须修改）：

// models/Post.js
import mongoose from 'mongoose';
const schema = new mongoose.Schema({ title: String, content: String });
export default mongoose.model('Post', schema);

• ES模块导入模型（必须加.js后缀）：

// controllers/postController.js
import Post from '../models/Post.js'; // ES模块要求显式写.js后缀，CommonJS不需要

3. 验证请求数据解析配置 #

Express默认不会解析JSON请求体，必须在主文件中添加express.json()中间件，否则req.body会是undefined，导致写入的属性全部为空：

// server.js
import express from 'express';
const app = express();

// 必须放在路由注册之前
app.use(express.json());

// 注册路由
import postRoutes from './routes/postRoutes.js';
app.use('/api/posts', postRoutes);

4. 检查控制器中的数据处理逻辑 #

确保创建文档实例时正确传递请求数据，并用async/await处理异步操作：

// controllers/postController.js
import Post from '../models/Post.js';

export const createPost = async (req, res) => {
  // 先打印req.body确认数据是否正确接收
  console.log('Received data:', req.body);
  if (!req.body.title || !req.body.content) {
    return res.status(400).json({ message: '缺少必填字段' });
  }

  try {
    const newPost = new Post(req.body);
    // 打印实例确认属性是否正确赋值
    console.log('Post实例:', newPost);
    const savedPost = await newPost.save();
    res.status(201).json(savedPost);
  } catch (err) {
    res.status(500).json({ message: err.message });
  }
};

5. 核对Schema字段与请求数据的匹配度 #

确保Schema中定义的字段名和前端传递的req.body字段完全一致（大小写敏感），比如Schema是title，前端传Title就会导致属性无法映射，最终写入undefined。

6. 同步修改MongoDB连接逻辑 #

ES模块下MongoDB连接代码也要调整导入方式：

// config/db.js
import mongoose from 'mongoose';

export const connectDB = async () => {
  try {
    await mongoose.connect(process.env.MONGO_URI);
    console.log('MongoDB连接成功');
  } catch (err) {
    console.error(err.message);
    process.exit(1);
  }
};

在server.js中导入并调用：

import { connectDB } from './config/db.js';
await connectDB();

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