Woocommerce支付成功钩子未触发求助（emerchantpay网关）

使用emerchantpay作为支付网关时，生产环境偶尔出现支付成功后不跳转的情况。尝试通过woocommerce_payment_complete和woocommerce_order_status_changed钩子实现降级方案，已将钩子添加至主控制器，但钩子未被触发（添加了var_dump和error_log均无记录）。代码如下：

public function init() 
{
    add_action('woocommerce_order_status_changed', [$this, 'status_changed', 10, 3]);
    add_action('woocommerce_payment_complete', [$this, 'woocommerce_payment_complete']);
}

public function status_changed( $id, $previous_status, $next_status )
{
    $order = new WC_Order($id);
    $order->update_status( 'completed' );
    var_dump('COMPLETE', $order);
    error_log('status_changed');
    exit;
}

public function woocommerce_payment_complete( $order_id )
{
    $order = wc_get_order( $order_id );
    $order->update_status( 'completed' );
    var_dump('COMPLETE', $order);
    error_log('woocommerce_payment_complete');
    exit;
}

1. 钩子注册错误（直接导致钩子未触发） #

你在注册woocommerce_order_status_changed钩子时参数顺序错误：
正确的add_action参数顺序是：add_action( $hook_name, $callback, $priority, $accepted_args )
你的代码中把优先级和参数个数写到了回调数组里，应该修正为：

public function init() 
{
    // 修正参数顺序：回调单独作为第二个参数，优先级和参数个数放在后面
    add_action('woocommerce_order_status_changed', [$this, 'status_changed'], 10, 3);
    add_action('woocommerce_payment_complete', [$this, 'woocommerce_payment_complete']);
}

2. 代码中的致命问题 #

• 方法里的exit会直接中断WordPress/WooCommerce的后续执行流程，即使钩子触发，也会导致站点异常，并且可能掩盖日志输出，必须删除。
• var_dump在生产环境的后台流程中无法直接查看，建议统一用error_log输出关键信息，同时避免重复更新订单状态：

public function status_changed( $id, $previous_status, $next_status )
{
    $order = wc_get_order($id); // 推荐用wc_get_order替代new WC_Order
    if ( $order && $next_status !== 'completed' ) {
        $order->update_status( 'completed' );
        error_log('status_changed触发：订单ID ' . $id . '，从' . $previous_status . '改为' . $next_status);
    }
}

public function woocommerce_payment_complete( $order_id )
{
    $order = wc_get_order( $order_id );
    if ( $order && $order->get_status() !== 'completed' ) {
        $order->update_status( 'completed' );
        error_log('woocommerce_payment_complete触发：订单ID ' . $order_id);
    }
}

3. 钩子触发条件说明 #

• woocommerce_payment_complete：仅当支付网关调用WC_Order->payment_complete()方法时才会触发。如果emerchantpay网关未调用该方法（比如直接修改订单状态而不触发标准流程），这个钩子不会生效。
• woocommerce_order_status_changed：仅当通过WC_Order->update_status()方法修改订单状态时才会触发。如果网关直接操作数据库修改订单状态，绕过WooCommerce的方法，这个钩子也不会触发。

4. 替代钩子与方案 #

如果上述钩子无法触发，建议采用以下更可靠的方案：

• IPN回调（优先推荐）：配置emerchantpay的IPN通知地址，支付成功后网关会主动向你的站点发送请求，这是处理支付结果最可靠的方式，不受前端跳转影响。在IPN回调接口中直接更新订单状态即可。
• transition_post_status钩子：因为WooCommerce订单是自定义文章类型，这个WordPress核心钩子会在任何文章（包括订单）状态变化时触发，覆盖范围更广：

  add_action('transition_post_status', [$this, 'handle_order_status_transition'], 10, 3);
  
  public function handle_order_status_transition($new_status, $old_status, $post) {
      if ( $post->post_type === 'shop_order' && $old_status !== $new_status ) {
          $order = wc_get_order($post->ID);
          if ( $order && $new_status !== 'completed' ) {
              $order->update_status('completed');
              error_log('transition_post_status触发：订单ID ' . $post->ID);
          }
      }
  }
  

• woocommerce_order_updated钩子：在订单的任何数据被更新时触发，包括状态变化，比状态专用钩子覆盖范围更广。

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