Woocommerce API回调不执行且返回-1值问题求助

核心原因 #

返回-1是WooCommerce API接口的默认错误响应，代表WooCommerce没有找到匹配你请求路径的API处理钩子，你的回调逻辑根本没有被触发，和你写的ocCallback方法内部逻辑无关。

具体触发场景 #

• 钩子注册时机错误：你没有在WooCommerce API初始化完成的生命周期节点注册回调钩子，导致API请求到来时，你的钩子还没有被注册到系统中。大部分开发者会直接在支付网关类的构造函数外注册钩子，或者依赖仅后台触发的钩子注册，都会导致前台API请求时钩子不生效。
• 网关ID与回调路径不匹配：woocommerce_api_拼接的$this->id值和你实际请求的回调URL路径后缀不匹配，比如ID含特殊字符、大小写错误、多/少空格，都会导致钩子匹配失败。比如你的ID是oc_pay，回调URL必须是https://你的站点域名/wc-api/oc_pay/，路径后缀必须和$this->id完全一致。
• 钩子注册逻辑未执行：如果你的支付网关类仅在后台初始化加载，前台请求时不会实例化支付网关类，那么写在类内部的钩子注册代码根本不会运行，自然无法匹配到回调。

解决方案 #

1. 调整钩子注册时机
   将钩子注册逻辑放到全局可触发的init钩子回调中，确保前台API请求时也能注册到对应的钩子，示例代码：

// 写在插件主文件中，不要放在仅后台执行的逻辑里
add_action('init', 'register_oc_pay_api_hook');
function register_oc_pay_api_hook() {
    // 确保你的支付网关类已经被加载
    if (class_exists('WC_Your_Oc_Pay_Gateway')) {
        $gateway = new WC_Your_Oc_Pay_Gateway();
        add_action( 'woocommerce_api_'.$gateway->id, array($gateway,'ocCallback') );
    }
}

2. 核对回调地址与网关ID一致性
   先打印确认你的支付网关ID值，确保回调URL的wc-api/后的部分和ID完全一致，示例获取ID的调试代码：

// 临时放到插件主文件，访问前台任意页面后查看源码里的ID值，用完删除
add_action('wp_head', function() {
    $gateway = new WC_Your_Oc_Pay_Gateway();
    echo '<!-- 支付网关ID：'.$gateway->id.' -->';
});

3. 回调方法内增加终止执行逻辑
   钩子匹配成功后，输出内容后要主动终止执行，避免WooCommerce后续逻辑覆盖你的响应，修改回调方法：

public function ocCallback(){
    echo 'ok';
    // 主动终止，防止后续逻辑输出多余内容
    exit;
}

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