WooCommerce下单后基于订单元数据向第三方发邮件失败问题咨询
问题排查与解决方案
1. 核心问题:钩子触发时机错误
woocommerce_new_order触发时机过早:该钩子在订单刚创建完成时就运行,此时 checkout 提交的自定义字段还未写入数据库,所以你查询到的两个邮箱值都是空值,自然走到失败通知分支,仅收到报错邮件。woocommerce_thankyou依赖用户跳转:只有用户付款后成功跳转到感谢页才会触发,如果用户支付后直接关闭页面、或者支付走异步回调流程,这个钩子就不会运行,所以完全不触发邮件发送。
推荐替换为woocommerce_checkout_order_processed钩子,该钩子会在所有订单自定义字段写入数据库后才触发,能稳定拿到字段值。
2. 现有代码隐性bug修复
你的代码还有两个容易被忽略的问题,也会导致取值失败:
- 写死数据库表前缀
wp_:如果你的WordPress修改过数据库表前缀,自定义SQL会直接查不到数据,哪怕数据库里已经存了字段值。 - 没必要直接操作数据库:WooCommerce提供了原生
get_meta()方法读取订单自定义字段,不需要自己写SQL,兼容性更强。
修复后的完整代码如下:
function custom_email_for_gift( $order_id ) { $order = wc_get_order( $order_id ); if ( ! $order ) return; // 用WooCommerce原生方法读取自定义字段,自动适配表前缀 $gift_to_person_email = $order->get_meta( 'gift_to_person_email' ) ?: ''; $gift_to_organization_email = $order->get_meta( 'gift_to_organization_email' ) ?: ''; $name = $order->get_billing_first_name(); $to = ''; if ( $gift_to_person_email ) { $to = $gift_to_person_email; } elseif ( $gift_to_organization_email ) { $to = $gift_to_organization_email; } $headers = array( 'Content-Type: text/html; charset=UTF-8' ); if ( $to && is_email( $to ) ) { $subject = '自定义邮件主题'; $email_content = '邮件正文内容'; wp_mail( $to, $subject, $email_content, $headers ); } else { $to = 'test@gmail.com'; $subject = '邮件发送失败'; $email_content = "失败原因:未获取到有效收件人邮箱"; $email_content .= ' 个人邮箱取值:' . $gift_to_person_email; $email_content .= ' 机构邮箱取值:' . $gift_to_organization_email; wp_mail( $to, $subject, $email_content, $headers ); } } // 优先级设置为20,保证在字段存储逻辑完成后再运行 add_action( 'woocommerce_checkout_order_processed', 'custom_email_for_gift', 20 );
3. 残留问题排查项
如果替换代码后仍无法正常发邮件,按以下顺序排查:
- 验证
wp_mail基础功能:写一段简单测试代码单独调用wp_mail发邮件到目标收件箱,确认服务器邮件发送功能正常、发件人地址未被收件箱拦截。 - 核对字段key:确认Checkout Field Editor插件里设置的字段meta key和代码里的
gift_to_person_email、gift_to_organization_email完全一致,大小写、拼写不能有任何偏差。 - 排查插件冲突:临时关闭其他邮件相关、WooCommerce自定义功能插件,测试功能是否正常,避免其他代码拦截了邮件发送流程。
- 加日志定位:可以在代码中把获取到的邮箱值写入WordPress系统日志,确认钩子触发时拿到的字段值是否符合预期,缩小问题范围。
内容的提问来源于stack exchange,提问作者Ajay Paudel
相关产品推荐
相关产品推荐

