调用WooCommerce REST API products端点返回空数组问题排查咨询

不一定是Bug，先排查这些常见场景 #

• 无已发布产品：WooCommerce REST API 默认仅返回已发布状态的产品。若你的产品处于草稿、私密、待审核或回收站状态，接口会返回空数组。可在请求中添加参数 status=any，获取所有状态的产品，示例请求路径：wp-json/wc/v3/products?status=any。
• 权限不足：即便身份验证通过，当前API用户可能缺少read_products权限。检查WooCommerce后台的API用户角色，确保其拥有查看产品的权限（如管理员、编辑者角色）。
• 产品被软删除：移至回收站的产品默认不会被返回，可通过status=trash参数单独获取这类产品。

调用wp-json/wc/v3/products需携带的请求头 #

基础必带头 #

• Content-Type: application/json：明确请求格式，GET请求虽无请求体，但该头可避免服务器解析异常。

身份验证头（二选一） #

• 基本认证：Authorization: Basic [base64编码的consumer_key:consumer_secret]，将你在WooCommerce后台生成的消费者密钥和密码用冒号连接后做base64编码，替换括号内内容即可。
• OAuth 1.0a认证：需携带oauth_consumer_key、oauth_signature、oauth_timestamp等多个签名相关头，安全性更高，适合生产环境，但配置更复杂。

进一步排查建议 #

1. 登录WooCommerce后台，确认存在已发布状态的产品，且数量正常。
2. 使用Postman或API测试工具重新发送请求，添加status=any参数，验证是否能返回产品数据。
3. 查看服务器日志，检查是否有API请求相关的权限警告或错误记录。

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