如何使用Sanity（Next.js）修改商品库存数量值？

核心逻辑 #

用Sanity官方客户端执行文档修改操作，在订单创建的流程里，同步调整对应商品的库存字段值。

具体实现步骤 #

1. 初始化Sanity客户端 #

先在代码里配置好具备读写权限的客户端（支持前端/Node.js环境）：

import { createClient } from '@sanity/client'

const client = createClient({
  projectId: '你的项目ID',
  dataset: '你的数据集名称',
  apiVersion: '2024-05-01', // 用最新的API版本
  token: '你的读写权限Token', // 必须要有文档编辑权限
  useCdn: false // 读写操作必须关闭CDN
})

2. 订单创建+库存同步逻辑 #

假设订单数据包含lineItems数组，每个元素有productId（商品的Sanity文档ID）和quantity（购买数量），可以这么写：

async function createOrderAndUpdateStock(orderData) {
  // 第一步：创建订单文档
  const order = await client.create({
    _type: 'order',
    customer: orderData.customer,
    lineItems: orderData.lineItems,
    total: orderData.total,
    createdAt: new Date().toISOString()
  })

  // 第二步：遍历订单商品，逐个更新库存
  for (const item of orderData.lineItems) {
    const product = await client.getDocument(item.productId)
    if (!product) continue

    // 计算新库存，避免出现负数
    const newStock = Math.max(0, product.stock - item.quantity)

    // 更新商品的库存字段
    await client.patch(item.productId)
      .set({ stock: newStock })
      .commit()
  }

  return order
}

3. 关键注意点 #

• 权限控制：确保使用的Token同时拥有订单文档的创建权限和商品文档的编辑权限，不然会报权限错误。
• 原子性保障：如果要保证“订单创建成功则库存必须更新，反之全部回滚”，可以用Sanity的事务API：

async function createOrderWithTransaction(orderData) {
  const transaction = client.transaction()

  // 加入创建订单的操作
  transaction.create({
    _type: 'order',
    customer: orderData.customer,
    lineItems: orderData.lineItems,
    total: orderData.total,
    createdAt: new Date().toISOString()
  })

  // 批量加入库存更新操作
  for (const item of orderData.lineItems) {
    transaction.patch(item.productId, (patch) => 
      patch.set({ stock: Math.max(0, patch.current.stock - item.quantity) })
    )
  }

  // 提交事务，要么全部成功要么全部失败
  await transaction.commit()
}

• 库存校验：建议在更新前先检查当前库存是否足够，比如判断product.stock >= item.quantity，如果库存不足就抛出错误中断流程，避免超卖。

4. 备选方案：Webhook触发 #

如果订单创建逻辑在外部服务（比如独立电商后端），可以给Sanity设置Webhook：当order文档被创建时，自动触发外部服务的接口，由该接口完成库存更新。这种方式适合前后端逻辑分离的场景。

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