Next.js中如何通过字符串_id正确使用ObjectId获取MongoDB文档？

错误原因 #

你在客户端代码中直接使用new ObjectId(str_id)会触发MongoDB库的客户端加密模块，该模块依赖Node.js专属的child_process模块，而浏览器环境不支持这个模块，因此报错。

正确解决方案 #

1. 客户端保持原样传字符串ID

不需要在客户端处理ObjectId转换，直接把字符串格式的_id传给后端API：

'use client'

// ...

const Page = () => {
  // ...

  fetch("api/get_data", {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      query: {
        "$match": { "_id": str_id }
      },
      limit: 1
    })
  })
}

2. 后端API中完成ObjectId转换

在Node.js环境的后端路由里导入ObjectId并转换ID，后端天然支持MongoDB的所有依赖：

import { ObjectId } from 'mongodb';

export async function POST(request: Request) {
  const body = await request.json();

  // 校验ID格式（可选但推荐）
  if (!ObjectId.isValid(body.query["$match"]._id)) {
    return Response.json({ error: "无效的ID格式" }, { status: 400 });
  }

  // 转换查询条件中的_id为ObjectId
  const modifiedQuery = {
    ...body.query,
    "$match": {
      "_id": new ObjectId(body.query["$match"]._id)
    }
  };

  const result = await DATA_COLLECTION?.aggregate([modifiedQuery])?.limit(body.limit)?.toArray();

  return Response.json(result || []);
}

3. 额外提示

• 确保后端安装的mongodb包版本正确，无需特殊配置，Node环境默认支持child_process模块。
• 建议新增ID格式校验，避免因无效ID导致数据库查询错误。

内容的提问来源于stack exchange，提问作者Manas R. Makde