如何将MongoDB商品接口从按ID查询改为按名称查询？

当然可以用{{URL}}/api/product/laptop-lenovo-slim-1这种slug格式来获取商品详情，以下是具体的技术实现方案：

1. 为商品添加Slug字段 #

建议在MongoDB的商品文档中新增slug字段，提前生成符合URL规则的slug字符串（相比实时转换名称，预存字段能提升查询性能，也便于处理重复名称场景）。

生成slug的核心规则：将商品名称转为小写，空格替换为连字符，移除特殊字符（若存在）。比如"Laptop Lenovo Slim 1"会被转为"laptop-lenovo-slim-1"。

生成Slug的示例代码 #

批量为已有商品生成slug（MongoDB Shell）

db.products.updateMany(
  { slug: { $exists: false } },
  [
    {
      $set: {
        slug: {
          $replaceAll: {
            input: { $toLower: "$name" },
            find: " ",
            replacement: "-"
          }
        }
      }
    }
  ]
);

单个生成slug的工具函数（Node.js）

function generateSlug(name) {
  return name
    .toLowerCase()
    .trim()
    .replace(/[^a-z0-9\s]/g, '') // 过滤特殊字符
    .replace(/\s+/g, '-'); // 空格替换为连字符
}

2. 修改API路由逻辑 #

以Express框架为例，将原有的ID匹配路由改为接受slug参数：

// 替换原有的ID路由
// app.get('/api/product/:id', async (req, res) => { ... })

// 新的slug匹配路由
app.get('/api/product/:slug', async (req, res) => {
  try {
    const { slug } = req.params;
    const product = await db.collection('products').findOne({ slug });
    
    if (!product) {
      return res.status(404).json({ message: '商品不存在' });
    }
    
    res.json(product);
  } catch (err) {
    res.status(500).json({ message: '服务器错误' });
  }
});

3. 处理重复Slug的场景 #

若存在名称相同的商品（比如同款不同配置但名称一致），直接生成的slug会重复，导致查询冲突。解决方法是在创建商品时检查slug唯一性，重复则追加序号：

async function createUniqueSlug(name) {
  let baseSlug = generateSlug(name);
  let slug = baseSlug;
  let count = 1;

  // 循环检查直到找到唯一slug
  while (await db.collection('products').findOne({ slug })) {
    slug = `${baseSlug}-${count}`;
    count++;
  }

  return slug;
}

// 创建新商品时使用
const newProduct = {
  name: "Laptop Lenovo Slim 1",
  slug: await createUniqueSlug("Laptop Lenovo Slim 1"),
  // 其他商品字段...
};

await db.collection('products').insertOne(newProduct);

4. 前端生成正确的详情链接 #

前端展示商品时，直接使用商品文档中的slug字段拼接URL即可：

<!-- 假设product是从后端获取的商品对象 -->
<a href="/api/product/{{product.slug}}">查看{{product.name}}详情</a>

内容的提问来源于stack exchange，提问作者Mujaddid Al Magribi