WooCommerce订单完成后相关钩子未触发问题求助

1. 调整钩子配置与代码逻辑 #

• 给钩子添加更高优先级，避免被Oxygen Builder的加载顺序覆盖，同时移除exit语句（它会中断WooCommerce后续流程，导致钩子触发不完整）：

  add_action( 'woocommerce_payment_complete', 'callback_function_2', 999, 1 );
  
  function callback_function_2( $orderid ){
      $to_email = 'xyxyxy@gmail.com';
      $payment = "payment text - woocommerce_payment_complete";
      $headers = 'From: Your Name <test@test.com>' . "\r\n"; // 注意用双引号解析换行符
      wp_mail($to_email, 'subject 2', $payment, $headers );
  }
  

  注：代码里的换行符要用双引号"\r\n"，单引号不会解析转义字符，可能导致邮件头无效。

2. 规避Oxygen Builder的代码作用域限制 #

Oxygen的自定义代码模块存在作用域隔离问题，建议把测试代码放到子主题的functions.php文件中，或者使用独立的自定义插件挂载钩子，避免被Oxygen的机制拦截。

3. 开启调试模式排查报错 #

在wp-config.php中添加调试配置，查看wp-content/debug.log是否有钩子触发相关的报错：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

4. 验证钩子触发条件与换用通用钩子 #

• woocommerce_payment_complete仅在订单从非支付状态变为支付完成状态时触发，手动修改订单状态不会触发该钩子，必须通过支付流程完成订单。
• 换用更通用的状态变更钩子测试，确认是否是特定钩子的问题：

  add_action( 'woocommerce_order_status_changed', 'test_order_status_trigger', 10, 4 );
  function test_order_status_trigger( $order_id, $old_status, $new_status, $order ) {
      error_log( "Order $order_id status changed: $old_status → $new_status" );
      wp_mail( 'xyxyxy@gmail.com', 'Order Status Update', "Order $order_id: $old_status → $new_status" );
  }
  

5. 排查支付网关与缓存影响 #

• 部分支付网关（如PayPal标准）依赖IPN通知更新订单状态，需确保服务器能接收外部请求，网关IPN配置正确。
• 暂时禁用Oxygen的缓存功能，测试用COD（货到付款）方式完成订单，排除网关和缓存的干扰。

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