通过WooCommerce REST API修改商品变体purchasable属性失败如何解决

核心原因 #

purchasable 是 WooCommerce 的 只读计算字段，不支持通过 REST API 直接修改。该字段的返回值由系统根据商品变体的其他属性实时计算生成，不属于持久化存储的可编辑字段，因此你尝试的两种修改方式都不会生效，既不是操作问题也不是 WooCommerce bug。

实现禁用变体购买的正确方案 #

你可以通过修改其他可编辑属性，让系统自动将 purchasable 计算为 false，常用方案如下：

• 方案1：设置变体为缺货且禁止补单，请求参数：

{
  "stock_status": "outofstock",
  "backorders": "no"
}

• 方案2：将变体调整为草稿状态，前端普通用户无法查看也无法购买，请求参数：

{
  "status": "draft"
}

• 方案3：清空变体的定价字段，无定价的商品会被系统判定为不可购买，请求参数：

{
  "regular_price": "",
  "sale_price": ""
}

• 方案4：如有自定义需求，可通过 woocommerce_variation_is_purchasable 钩子自定义 purchasable 字段的计算逻辑，配合自定义字段的修改实现更灵活的购买控制。

结果验证 #

完成上述属性修改后，再次调用 GET 接口拉取变体数据，返回的 purchasable 字段会自动更新为目标值。

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