WooCommerce订单processing状态下functions.php自定义邮件发送问题排查

现有代码的核心错误 #

• 触发钩子使用错误：原代码绑定的woocommerce_payment_processing并非WooCommerce官方提供的状态变更触发钩子，对应自定义函数完全不会被执行，自然不会发送邮件。订单转入processing状态的正确触发钩子为woocommerce_order_status_processing。
• 收件人获取逻辑错误：原代码中$order["billing_address"]获取的是完整账单地址集合，并非用户的联系邮箱，就算钩子正常触发也无法投递到正确收件箱。
• 缺少HTML格式声明：发送内容包含HTML标签，但wp_mail默认使用纯文本格式投递，未声明Content-type会导致邮件内容被解析为纯文本乱码，进而被邮箱服务商判定为垃圾邮件拦截。
• 冗余无效代码：函数外部多余的$order = new WC_Order( $order_id );在全局作用域执行时$order_id未定义，属于无意义代码，可能引发隐蔽的兼容性问题。

修正后的完整实现代码 #

// 订单进入processing状态时触发自定义邮件
add_action( 'woocommerce_order_status_processing', 'send_custom_processing_order_email', 10, 1 );
function send_custom_processing_order_email( $order_id ) {
    // 无效订单ID直接终止执行
    if ( ! $order_id ) return;
    $order = wc_get_order( $order_id );
    // 订单对象无效则终止
    if ( ! $order ) return;
    // 获取用户账单邮箱，无有效邮箱则终止
    $to_email = $order->get_billing_email();
    if ( ! $to_email ) return;
    // 配置邮件头：发件人 + HTML格式声明
    $headers = [
        'From: Your Name <alexiglesiasvortex@gmail.com>',
        'Content-Type: text/html; charset=UTF-8'
    ];
    // 自定义邮件内容与主题
    $subject = '你的订单已进入处理状态';
    $message = '<h1>自定义订单处理通知</h1><p>你的订单已完成支付，我们将尽快为你安排发货</p>';
    // 调用邮件发送方法
    wp_mail( $to_email, $subject, $message, $headers );
}

修正后仍未送达的排查步骤 #

• 确认服务器邮件服务可用性：wp_mail默认依赖服务器自带的mail()函数，多数虚拟主机会限制该函数权限，或被主流邮箱服务商拦截。可临时通过代码输出wp_mail的返回值，确认是函数执行失败还是投递被拦截。
• 开启调试日志定位问题：在wp-config.php中添加如下配置，触发订单状态变更后查看wp-content/debug.log中的记录，确认自定义函数是否被触发、是否存在参数错误等问题

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

• 校验订单状态是否匹配：Stripe测试模式支付完成后，进入订单后台确认状态是否真的为processing，如果因站点风控、库存校验等逻辑导致状态转为on-hold或其他状态，当前钩子不会触发。
• 排查其他拦截逻辑：检查主题或其他自定义功能中是否存在修改wp_mail发送规则的代码，避免自定义邮件被其他过滤逻辑拦截。

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