Express/Mongo无法解析Postman注册POST请求，抛出BulkWriteError

兄弟，我一眼就看出你这问题大概率是请求体没被Express正确解析，导致req.body拿不到Postman发送的数据，最终Mongo收到的username是null，触发了唯一索引的重复报错！我之前开发Express注册功能时踩过一模一样的坑，给你一步步排查解决：

1. 先检查Express的请求体解析中间件（最常见原因） #

Express默认不会自动解析JSON或表单格式的请求体，所以必须在你的主入口文件（比如app.js）里添加以下中间件配置，否则req.body会是undefined：

const express = require('express');
const app = express();

// 关键！添加这两行解析请求体
app.use(express.json()); // 解析JSON格式的请求体
app.use(express.urlencoded({ extended: true })); // 解析URL编码的表单数据

// 然后挂载你的用户路由
const usersRouter = require('./routes/Users');
app.use('/users', usersRouter);

app.listen(3000, () => console.log('服务器启动在3000端口'));

如果没加这两个中间件，你在/register路由里拿到的req.body.username会是undefined，Mongoose存数据时会把它转成null；而如果你的User Schema里username设了unique: true，第一个请求插入null后，第二个请求就会报BulkWriteError说null已被占用。

2. 检查Postman的请求配置是否正确 #

确保你在Postman里的请求符合要求：

• 请求方法选POST，URL填写正确（比如http://localhost:3000/users/register）
• 切换到Body标签：
  • 如果发送JSON数据，选raw -> 格式选JSON，输入如下格式的内容：

    {
      "username": "test_user_01",
      "email": "test@example.com",
      "password": "your_secure_password"
    }
    

  • 如果发送表单数据，选form-data，然后添加username、email、password对应的键值对

3. 验证Mongo Schema的字段配置 #

检查你的User Schema里username字段的定义，确认是否开启了required和unique：

const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
  username: {
    type: String,
    required: [true, '用户名不能为空'], // 必填
    unique: true, // 唯一索引
    trim: true // 可选：去除首尾空格
  },
  email: {
    type: String,
    required: true,
    unique: true,
    lowercase: true
  },
  password: {
    type: String,
    required: true
  }
});

module.exports = mongoose.model('User', userSchema);

如果required设为true，但req.body.username拿不到值，Mongoose会把它设为null，而unique索引会阻止重复的null插入，这就是你看到的报错根源。

4. 添加调试日志确认请求体 #

在你的/register路由里加一句日志，确认是否拿到了Postman发送的数据：

router.post('/register', function (req, res, next) {
  // 调试用：打印请求体，看是否有数据
  console.log('收到的请求体内容:', req.body);
  
  let username = req.body.username;
  let email = req.body.email;
  // 后续的注册逻辑...
});

如果控制台打印出来的是{}或者undefined，那肯定是中间件或Postman的配置问题，回到前两步排查即可。

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