PowerShell调用WooCommerce API筛选特定角色订单问题排查

你的问题核心是角色判断逻辑不严谨：要么是分开获取订单和用户列表后匹配出错，要么是只检查用户是否包含public角色，没排除Invoice、Cashcustomers等其他角色的干扰。下面是两种可靠的解决思路：

方法1：通过WooCommerce API直接过滤（高效推荐） #

利用WooCommerce REST API的参数，直接获取processing状态且用户角色为public的订单，减少本地处理量：

# 配置商店API信息
$wcStoreUrl = "https://你的商店域名/wp-json/wc/v3"
$apiKey = "你的消费者密钥"
$apiSecret = "你的消费者密码"
$authToken = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("$apiKey:$apiSecret"))

# 直接拉取符合条件的订单：processing状态 + public角色用户
$targetOrders = Invoke-RestMethod -Uri "$wcStoreUrl/orders?status=processing&customer_role=public" -Method Get -Headers @{ "Authorization" = $authToken }

# 处理订单
foreach ($order in $targetOrders) {
    Write-Host "处理订单 #$($order.id)，关联用户ID：$($order.customer_id)"
    # 在这里添加你的订单处理逻辑，比如修改状态、发送通知等
}

注：如果你的商店用的是WooCommerce默认前台用户角色（customer），把customer_role=public改成customer_role=customer即可，确保角色名称和后台完全一致（大小写敏感）。

方法2：获取订单后严格验证用户角色 #

如果API过滤不生效（比如自定义角色不支持参数过滤），就先拿所有processing订单，再逐个验证用户角色：

# 配置API信息
$wcStoreUrl = "https://你的商店域名/wp-json/wc/v3"
$apiKey = "你的消费者密钥"
$apiSecret = "你的消费者密码"
$authToken = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("$apiKey:$apiSecret"))

# 获取所有processing状态的订单
$processingOrders = Invoke-RestMethod -Uri "$wcStoreUrl/orders?status=processing" -Method Get -Headers @{ "Authorization" = $authToken }

foreach ($order in $processingOrders) {
    # 跳过没有关联用户的订单
    if (-not $order.customer_id) { continue }

    # 获取该订单对应的用户信息
    $user = Invoke-RestMethod -Uri "$wcStoreUrl/customers/$($order.customer_id)" -Method Get -Headers @{ "Authorization" = $authToken }

    # 严格判断：用户只有public角色，没有其他角色
    if ($user.roles.Count -eq 1 -and $user.roles[0] -eq "public") {
        Write-Host "处理订单 #$($order.id)，用户ID：$($order.customer_id)（仅public角色）"
        # 执行你的处理逻辑
    }

    # 如果允许用户有多个角色，但要排除Invoice/Cashcustomers等，用下面的判断：
    # if ($user.roles -contains "public" -and ($user.roles | Where-Object { $_ -notin @("public") }).Count -eq 0) {
    #     Write-Host "处理订单 #$($order.id)，用户ID：$($order.customer_id)"
    #     # 执行处理逻辑
    # }
}

关键注意事项 #

• 角色名称要完全匹配：后台用户角色的名称（不是显示名）必须和脚本里的一致，比如后台角色是Public User，但API返回的是public_user，就得用后者。
• 减少API请求：如果订单量很大，方法1的API过滤能避免大量用户查询请求，效率更高；如果用方法2，建议批量获取所有public角色用户的ID列表，再和订单的customer_id匹配，减少单个用户查询。

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