MongoDB自增ID失效：使用Mongoose+Express创建数字_id用户集合失败

我之前折腾自增数字ID替代MongoDB默认ObjectId的时候，也踩过好几个坑。咱们从核心环节逐个排查，应该能定位到你代码里的问题：

1. 计数器集合（counter.js）的初始化与逻辑问题 #

这是最容易出问题的环节，先确保你的计数器模型和初始化逻辑没毛病：

• 必须初始化基础计数器文档：如果应用启动时没检查并创建userId对应的计数器，第一次注册用户会找不到序列，直接导致_id生成失败。可以在模型文件里加一段启动时执行的初始化代码：

  // counter.js
  const mongoose = require('mongoose');
  
  const counterSchema = new mongoose.Schema({
    _id: { type: String, required: true }, // 用"userId"作为这个计数器的唯一标识
    seq: { type: Number, default: 0 }
  });
  
  const Counter = mongoose.model('Counter', counterSchema);
  
  // 启动时初始化计数器（不存在则创建）
  Counter.findOneAndUpdate(
    { _id: 'userId' },
    { $setOnInsert: { seq: 0 } },
    { upsert: true, new: true }
  ).catch(err => console.error('初始化计数器失败:', err));
  
  module.exports = Counter;
  

• 确保findOneAndUpdate参数正确：一定要加upsert: true（不存在则自动创建）和new: true（返回更新后的最新文档），不然拿不到递增后的seq值。

2. 用户模型（user.js）的Schema与预保存钩子问题 #

这里的核心是覆盖MongoDB默认的ObjectId生成逻辑：

• 显式定义_id为Number类型：必须在Schema里明确指定_id的类型，否则Mongoose会自动生成ObjectId，直接导致类型冲突：

  // user.js
  const mongoose = require('mongoose');
  const Counter = require('./counter');
  
  const userSchema = new mongoose.Schema({
    _id: { type: Number, required: true }, // 强制声明为Number类型
    username: { type: String, required: true, unique: true },
    password: { type: String, required: true }
    // 其他自定义字段...
  });
  
  // 预保存钩子生成自增ID
  userSchema.pre('save', async function(next) {
    try {
      // 仅新建用户时生成ID（避免更新用户时覆盖原有ID）
      if (this.isNew) {
        const counter = await Counter.findOneAndUpdate(
          { _id: 'userId' },
          { $inc: { seq: 1 } },
          { upsert: true, new: true }
        );
        this._id = counter.seq; // 将自增序列赋值给用户的_id
      }
      next();
    } catch (err) {
      next(err); // 把错误传递给Express的错误处理中间件
    }
  });
  
  module.exports = mongoose.model('User', userSchema);
  

• 注意异步钩子的错误处理：用async写钩子时，一定要用try/catch捕获错误并调用next(err)，不然错误会被Mongoose吞掉，你根本看不到具体报错。另外，判断this.isNew能避免更新用户时重新生成ID。

3. 路由中的调用问题 #

最后检查你的POST注册接口有没有正确处理异步逻辑：

• 必须等待用户保存完成：如果路由里没加await，会导致还没生成ID就返回响应，或者保存过程出错但没被捕获：

  // 路由文件示例
  const express = require('express');
  const router = express.Router();
  const User = require('../models/user');
  const bcrypt = require('bcrypt'); // 假设你用bcrypt加密密码
  
  router.post('/register', async (req, res) => {
    try {
      // 先检查用户名是否已存在
      const existingUser = await User.findOne({ username: req.body.username });
      if (existingUser) {
        return res.status(400).json({ message: '用户名已存在' });
      }
  
      // 加密密码
      const hashedPassword = await bcrypt.hash(req.body.password, 10);
      const user = new User({
        username: req.body.username,
        password: hashedPassword
        // 不要手动传_id，预保存钩子会自动生成
      });
  
      const savedUser = await user.save();
      res.status(201).json({ 
        message: '注册成功',
        user: { id: savedUser._id, username: savedUser.username }
      });
    } catch (err) {
      console.error('注册失败:', err); // 打印错误日志，方便排查
      res.status(500).json({ message: '服务器内部错误' });
    }
  });
  
  module.exports = router;
  

• 不要手动传入_id：如果创建User实例时手动传了_id，会直接覆盖预保存钩子生成的值，导致逻辑混乱。

几个快速排查小技巧 #

1. 打开MongoDB Compass或用命令行查看counters集合，确认是否有_id为userId的文档，seq值是否正常递增；
2. 在控制台打印预保存钩子和路由里的错误信息，很多时候错误提示会直接告诉你问题（比如_id类型不匹配、计数器不存在等）；
3. 确保你的Mongoose版本和代码兼容，部分老版本Mongoose处理异步预保存钩子的逻辑有差异。

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