使用Automattic/WooCommerce包同步Laravel与WooCommerce客户数据遇空数组问题

问题概述 #

使用Automattic/WooCommerce包将WooCommerce数据同步到Laravel时，商品、订单数据可正常获取，但调用customers端点始终返回空数组。已通过以下命令安装包：

composer require automattic/woocommerce

相关代码片段：

$since_id = 0;
$url            =   $this->store['store_url'];
$consumer_key   =   $this->store['consumer_key'];
$consumer_secret=   $this->store['consumer_secret'];
$options        =   [ 'wp_api' => true, 'version' => 'wc/v3' ];
$woocommerce    =   new Client($url, $consumer_key, $consumer_secret, $options);

$page = 1;
$per_page = 100; // 设置合理限制避免过载
$limit = 10000;
$all_customers = [];
do {
    $args = [
        'per_page' => $per_page,
        'page' => $page,
    ];
    $customers = $woocommerce->get('customers', $args);
    $all_customers = array_merge($all_customers, $customers);
    // 检查是否有更多数据
    $page++;
} while (count($customers) >= $per_page);

WooCommerce返回的响应显示客户端初始化正常，但客户数据为空数组。

排查与解决步骤 #

1. 确认API密钥权限 #

创建WooCommerce API密钥时，需确保密钥拥有读取客户的权限：

• 登录WooCommerce后台，进入「WooCommerce > 设置 > 高级 > REST API」
• 查看对应密钥的权限，必须是「Read/Write」或至少「Read」（建议先测试「Read/Write」权限，排除权限限制问题）

2. 直接测试API端点 #

跳过Laravel代码，用工具直接请求API验证：

• 使用curl命令：

curl -u ck_6d519e5d047a33003acc6e9b2c9504c05569dc58:cs_86fd82a32a6c7a347861d2f5f3ca26adfca105e2 http://localhost:10028/wp-json/wc/v3/customers?per_page=100&page=1

• 或用Postman等工具，选择Basic Auth，用户名填consumer key，密码填consumer secret，请求上述URL
• 如果直接请求也返回空：检查WooCommerce后台是否有注册客户（访客下单默认不会生成客户记录）
• 如果直接请求有数据：说明问题出在Laravel代码的请求逻辑中

3. 捕获API请求错误 #

在代码中添加异常捕获，查看具体错误信息：

try {
    $customers = $woocommerce->get('customers', $args);
} catch (\Automattic\WooCommerce\HttpClient\HttpClientException $e) {
    // 打印错误详情
    var_dump($e->getMessage());
    var_dump($e->getResponse()->getStatusCode());
    var_dump($e->getRequest()->getUrl());
}

常见错误如403（权限不足）、404（端点错误），可快速定位问题。

4. 检查WooCommerce客户数据 #

登录WooCommerce后台，进入「客户」页面：

• 确认存在已注册的客户（访客下单不会自动创建客户账号，需用户主动注册）
• 如果没有客户数据，空数组是正常返回，需先创建测试客户

5. 调整分页参数测试 #

尝试降低per_page的值（比如改为20），部分服务器对请求参数有严格限制：

$args = [
    'per_page' => 20,
    'page' => $page,
];

6. 确认WooCommerce版本兼容性 #

确保WooCommerce版本支持REST API v3：

• WooCommerce 3.0及以上版本支持v3 API，若版本过低，需升级WooCommerce或改用v2 API

内容的提问来源于stack exchange，提问作者Salman Khan Sohoo