本文详解 woocommerce rest api 批量更新（`/products/batch`）无响应问题的根本原因——错误构造 json 请求体，并提供符合官方规范的 python 实现方法，确保 `update` 数组被正确序列化为字典结构而非字符串。
在使用 WooCommerce REST API 进行产品批量更新时，一个极易被忽视却致命的问题是：手动拼接 JSON 字符串（如 "{"update": [...]}"）会导致请求体被当作纯文本发送，而非合法的 JSON 对象。正如日志中所示，虽然响应状态码为 200 OK，但 Response Body 中 data: [] 且无实际更新，这正是 API 因解析失败而静默跳过整个 update 指令的典型表现。
根本原因在于：WooCommerce 的 /products/batch 端点严格要求请求体为标准 JSON 格式对象，其顶层必须是包含 update（数组）、create 或 delete 键的字典。而原始代码中：
str_start = "{\"update\": ["
d = ", ".join(str(n) for n in one_product_batch) # ❌ 将 dict 转为字符串，破坏结构
data = str_start + d + str_end # ❌ 最终是字符串，非字典
response = wcapi.post("products/batch", data).json() # ❌ wcapi 会将字符串作为 raw body 发送这导致请求体成为非法 JSON 字符串（如 "{"update": [{"id":8056,...}]}"），服务器无法解析 update 字段，故返回空 data 数组且不报错。
✅ 正确做法是：始终以 Python 字典（dict）形式构建请求数据，并交由 wcapi.post() 自动序列化为合规 JSON：
# ✅ 正确：用原生字典结构组织数据
product_list = [
{
'id': 8056,
'manage_stock': True, # ⚠️ 建议用布尔值而非字符串
'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 payload 字典（非字符串）
batch_size = 100
for i in range(0, len(product_list), batch_size):
batch = product_list[i:i + batch_size]
payload = {'update': batch} # ← 关键：字典，非字符串
print(f"__________ BATCH {i} ({len(batch)} products) __________")
response = wcapi.post("products/batch", payload).json() # wcapi 自动处理 JSON 序列化
if 'update' in response and len(response['update']) > 0:
print(f"✓ Updated {len(response['update'])} products")
else:
print("⚠ Warning: No products updated — check response or product IDs")
print("Response:", response)? 关键注意事项：
- 不要手动 json.dumps() 或字符串拼接：wcapi 库内部已处理序列化；传入 dict 即可。
- 布尔值建议用 True/False：WooCommerce 接受 'true' 字符串，但 True 更规范且避免类型歧义。
-
验证产品 ID 存在性：无效 ID 不会报错，但对应产品不会被更新，建议先用 GET /products/
预检。 - 批量大小建议 ≤ 100：避免超时或内存压力；生产环境可结合 time.sleep(0.1) 限流。
- 检查响应结构：成功响应中 response['update'] 是已更新产品的列表（含 id, name 等），可据此确认结果。
通过遵循字典优先、结构合规、交由 SDK 序列化的原则，即可彻底解决“无响应、无报错、无更新”的批量更新失效问题，让自动化库存与价格同步稳定可靠运行。
