本文详解 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 序列化的原则，即可彻底解决“无响应、无报错、无更新”的批量更新失效问题，让自动化库存与价格同步稳定可靠运行。