本文详解 woocommerce rest api 批量更新（`/products/batch`）失败的核心原因：错误构造 json 请求体（如手动拼接字符串导致格式非法），并提供符合官方规范的 python 实现方案，确保请求被正确解析与响应。
在使用 WooCommerce REST API 进行批量产品更新时，一个极其常见却容易被忽视的问题是：请求看似成功（返回 HTTP 200），但实际未生效，且无任何错误提示。从你提供的 API 日志可清晰定位根本原因——请求体（Body Content）格式非法。
观察你的原始请求 Body Content：
"{"update": [{...}, {...}]}"这是一个被双引号包裹的字符串，而非合法的 JSON 对象。WooCommerce 服务器收到后无法解析 update 字段，因此静默忽略整个 payload，仅返回空响应 {"data": []} 和状态码 200（表示“请求已接收”，但未执行任何更新）。
✅ 正确做法是：让 Python 的 requests 库（或 woocommerce-api 客户端）自动序列化为标准 JSON，即传入一个原生 Python 字典（dict），而非手动拼接的字符串。
✅ 正确的请求结构
批量更新必须严格遵循 WooCommerce 官方文档要求的结构：
data = {
"update": [
{
"id": 8056,
"manage_stock": True, # 注意：布尔值应为 Python bool，非字符串
"stock_quantity": 5,
"name": "Product_1",
"status": "publish",
"regular_price": "12.95",
"categories": [{"id": 21485}]
},
# ... 更多产品字典
]
}⚠️ 关键修正点：manage_stock 必须是 True 或 False（Python 布尔类型），不是 "true" 字符串（WooCommerce 会将其视为无效值）；整个 data 是一个 dict，由客户端自动 json.dumps() 发送，绝不可手动拼接 JSON 字符串；categories 等嵌套字段需确保是合法列表/字典结构。
✅ 推荐的 Python 批量更新代码（使用 woocommerce-api）
from woocommerce import API
wcapi = API(
url="https://your-store.com",
consumer_key="ck_xxx",
consumer_secret="cs_xxx",
version="wc/v3"
)
# 构建产品更新列表（注意：使用原生 Python 类型）
product_list = [
{
"id": 8056,
"manage_stock": True, # ← 必须是 bool
"stock_quantity": 5,
"name": "Product_1",
"status": "publish",
"regular_price": "12.95",
"categories": [{"id": 21485}]
},
{
"id": 44848,
"manage_stock": True,
"stock_quantity": 48,
"name": "Product_2",
"status": "publish",
"regular_price": "0.3",
"categories": [{"id": 21485}]
}
# ... 添加更多产品
]
# 分批发送（建议 batch_size ≤ 100，避免超时或内存压力）
batch_size = 50
for i in range(0, len(product_list), batch_size):
batch = product_list[i:i + batch_size]
payload = {"update": batch} # ← 核心：传入 dict，非字符串
print(f"→ 正在更新第 {i//batch_size + 1} 批（{len(batch)} 个产品）...")
response = wcapi.post("products/batch", payload).json()
# 检查响应有效性
if "update" in response and len(response["update"]) > 0:
updated_count = len(response["update"])
print(f"✓ 成功更新 {updated_count} 个产品")
# 可选：打印更新后的产品 ID 和状态
for item in response["update"]:
print(f" ID {item['id']}: {item['name']} → {item['status']}")
else:
print("⚠ 批量更新失败或未返回更新数据，请检查日志与权限")
print("响应内容:", response)? 调试建议
- 启用 WooCommerce REST API 日志插件（如你已做），重点检查 Body Content 是否为合法 JSON 对象（无外层引号、无转义错误）；
- 验证 API 凭据权限：确保 consumer key 具备 edit_products 能力（通常需管理员或编辑角色）；
- 检查单个产品 ID 是否真实存在：/products/batch 对无效 ID 会静默跳过，不报错；
- 留意速率限制：高频请求可能触发 429 错误，添加 time.sleep(0.1) 缓冲。
✅ 总结
WooCommerce /products/batch 接口对请求体格式极为敏感。永远避免手动拼接 JSON 字符串，坚持使用 Python 原生数据结构（dict/list）并交由 HTTP 客户端序列化。同时确保布尔字段（manage_stock）、数值字段（stock_quantity）和嵌套结构（categories）符合 API 规范。遵循此模式，即可稳定、高效地完成大批量商品更新任务。
