WooCommerce订单完成后后台触发API URL的问题排查

我需要在WooCommerce订单状态变为「已完成」时，后台静默调用一个带订单变量的API接口，不需要跳转或展示给客户。我已经写了绑定woocommerce_order_status_completed钩子的函数，用CURL实现后台请求，但发现动态拼接变量后的URL无法触发API，静态写死URL却能正常工作——虽然alert弹出的动态URL是完全正确的。

我的代码如下：

add_action('woocommerce_order_status_completed', 'custom_process_order');
function custom_process_order($order_id) {
 // Get the order info
 $order = wc_get_order( $order_id );
 if($order->get_billing_country() == "NL"){
 // create a new cURL resourc
 $ch = curl_init();
 $voornaam = $order->get_billing_first_name();
 $achternaam = $order->get_billing_last_name();
 $email = $order->get_billing_email();
 echo '<script type="text/javascript">alert("https://klantenvertellen.nl/v1/invite/external?hash=0926-4adb-a39e-d04110d1e445&amp;location_id=104679&amp;tenantId=99&amp;invite_email='.$email.'&amp;delay=1&amp;first_name='.$voornaam.'&amp;last_name='.$achternaam.'&amp;language=nl");</script>';
 // set URL and other appropriate options
 curl_setopt($ch, CURLOPT_URL, 'https://klantenvertellen.nl/v1/invite/external?hash=0926-4adb-a39e-d04110d1e445&amp;location_id=10479&amp;tenantId=99&amp;invite_email='.$email.'&amp;delay=1&amp;first_name='.$voornaam.'&amp;last_name='.$achternaam.'&amp;language=nl');
 curl_setopt($ch, CURLOPT_HEADER, 0);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 // grab URL and pass it to the browser
 curl_exec($ch);
 // close cURL resource, and free up system resources
 curl_close($ch);
 }
}

问题根源分析 #

你遇到的核心问题是URL中的HTML实体编码（&）导致CURL请求地址无效：

• 在前端alert的JS代码里，浏览器会自动把&解析成正常的参数分隔符&，所以弹出的URL是正确的；
• 但CURL不会处理HTML实体，它会直接把&当作URL的一部分发送给API，这就导致接口无法识别参数格式，请求自然失败。

另外还有一个小细节：你alert里的location_id=104679和CURL里的location_id=10479参数值不一致，虽然这不是请求失败的主因，但建议统一参数值避免后续问题。

修复方案 #

1. 修正URL格式 + 变量URL编码 #

把URL里的&替换成原生&，同时对用户信息变量做URL编码（避免姓名/邮箱含特殊字符导致URL格式错误），再添加错误调试代码方便排查问题：

add_action('woocommerce_order_status_completed', 'custom_process_order');
function custom_process_order($order_id) {
    // 获取订单对象
    $order = wc_get_order($order_id);
    if ($order->get_billing_country() == "NL") {
        // 对变量做URL编码，处理特殊字符
        $voornaam = urlencode($order->get_billing_first_name());
        $achternaam = urlencode($order->get_billing_last_name());
        $email = urlencode($order->get_billing_email());
        
        // 拼接正确的URL（用&分隔参数，无需HTML实体编码）
        $api_url = "https://klantenvertellen.nl/v1/invite/external?hash=0926-4adb-a39e-d04110d1e445&location_id=104679&tenantId=99&invite_email={$email}&delay=1&first_name={$voornaam}&last_name={$achternaam}&language=nl";
        
        // 初始化CURL
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $api_url);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // 添加超时设置，避免阻塞后台流程
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        
        // 执行请求并捕获错误
        $response = curl_exec($ch);
        if (curl_errno($ch)) {
            // 记录错误日志到WP后台（工具->站点健康->日志可查看）
            error_log("CURL请求失败: " . curl_error($ch));
        } else {
            // 可选：记录API响应日志
            error_log("API响应内容: " . $response);
        }
        
        // 释放CURL资源
        curl_close($ch);
    }
}

2. 更推荐：使用WordPress内置HTTP函数 #

WooCommerce/WordPress提供了wp_remote_get()函数，比原生CURL更适配WP环境，自动处理参数编码和资源释放，还支持异步请求避免拖慢订单流程：

add_action('woocommerce_order_status_completed', 'custom_process_order');
function custom_process_order($order_id) {
    $order = wc_get_order($order_id);
    if ($order->get_billing_country() == "NL") {
        // 整理API参数数组
        $params = array(
            'hash' => '0926-4adb-a39e-d04110d1e445',
            'location_id' => '104679',
            'tenantId' => '99',
            'invite_email' => $order->get_billing_email(),
            'delay' => '1',
            'first_name' => $order->get_billing_first_name(),
            'last_name' => $order->get_billing_last_name(),
            'language' => 'nl'
        );
        
        // 自动拼接并编码参数
        $api_url = add_query_arg($params, 'https://klantenvertellen.nl/v1/invite/external');
        
        // 发起非阻塞请求（不影响订单完成速度）
        $response = wp_remote_get($api_url, array(
            'timeout' => 10,
            'blocking' => false
        ));
        
        // 捕获错误日志
        if (is_wp_error($response)) {
            error_log("API请求错误: " . $response->get_error_message());
        }
    }
}

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