通过PrestaShop WebService更新库存后GET请求返回quantity=0的问题求助

我之前在做PrestaShop API开发时也碰到过一模一样的问题——后台库存显示正常，但API GET返回的quantity始终是0。给你梳理几个最可能的原因，你可以逐个排查：

• Stock Available ID 不匹配
  PrestaShop里单个产品可能对应多个stock_availables条目（比如不同仓库、不同属性组合的变体）。你通过PUT更新的可能只是其中一个，而GET查询的是另一个完全不同的库存项。
  建议先调用GET /api/stock_availables?filter[id_product]=[你的产品ID]，列出该产品所有关联的库存条目，确认你PUT时用的id_stock_available和GET查询的是同一个。如果是组合产品，还要注意id_product_attribute是否对应正确的变体。

• API 请求字段或参数错误
  有些新手容易犯的错误：一是PUT时字段名写错（比如用qty代替了官方要求的quantity），导致库存根本没更新到正确的字段；二是多店铺模式下，PUT和GET请求的id_shop参数不一致——比如你更新了主店铺的库存，但查询的是子店铺的，结果自然不对。
  检查你的PUT请求体，确保是<stock_available><quantity>10</quantity></stock_available>这类正确格式；如果是多店铺，记得在请求URL里带上&id_shop=[目标店铺ID]，且PUT和GET保持一致。

• 缓存导致的旧数据返回
  PrestaShop的后台缓存、API响应缓存甚至服务器层面的缓存（比如Varnish、Redis）都可能让GET请求返回旧的库存值。
  先试试在后台手动清空缓存（路径：高级参数→性能→清空缓存），然后在GET请求URL末尾加&nocache=1强制绕过API缓存。如果用了服务器端缓存，也需要同步清空。

• 产品库存设置冲突
  虽然你说后台显示正常，但还是要确认下产品的基础设置：比如产品是否被设为“虚拟产品”或“不需要库存管理”？这类设置会强制stock_availables的quantity字段为0，但后台可能显示的是其他逻辑值。去后台产品编辑页的「库存」标签，检查“是否需要库存管理”是否勾选，以及“虚拟产品”选项是否关闭。

• API版本兼容性问题
  不同PrestaShop版本的API行为差异很大，比如1.6和1.7在stock_availables的处理上就有不少区别。比如1.7的部分版本中，更新组合产品的库存时，必须同时指定id_product_attribute，否则更新不会生效到对应的变体上。
  确认你的API请求格式和当前PrestaShop版本匹配，比如如果是1.7.x，组合产品的PUT请求要包含<id_product_attribute>[变体ID]</id_product_attribute>字段。

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