本文介绍通过 woocommerce_thankyou 钩子结合前端 JavaScript 实现订单支付完成后的无刷新自动跳转，精准作用于客户端页面，避免影响后台管理操作。
本文介绍通过 `woocommerce_thankyou` 钩子结合前端 javascript 实现订单支付完成后的无刷新自动跳转，精准作用于客户端页面，避免影响后台管理操作。
在 WooCommerce 中，当用户完成银行转账等异步支付方式后，订单状态常由第三方回调或定时任务更新为 completed，此时用户仍停留在支付说明页，需主动跳转至标准感谢页（Thank You Page）。直接使用 PHP 的 wp_redirect() 在 woocommerce_thankyou 钩子中无效——因为该钩子触发时 HTML 响应已开始输出，HTTP 头无法修改；而使用 wp_safe_redirect() 同样受限于输出缓冲状态。
✅ 正确方案是：在 woocommerce_thankyou 钩子中注入轻量级 JavaScript 重定向逻辑。该钩子仅在客户成功访问感谢页（即 /checkout/order-received/{order_id}/）时触发，天然隔离后台编辑场景（如管理员在订单列表或编辑页更改状态不会触发此钩子），完美满足“仅对客户生效”的需求。
以下为推荐实现代码（请添加至主题的 functions.php 或自定义插件中）：
add_action( 'woocommerce_thankyou', 'wc_auto_redirect_on_completed_status', 10, 1 );
function wc_auto_redirect_on_completed_status( $order_id ) {
$order = wc_get_order( $order_id );
if ( ! $order || ! in_array( $order->get_status(), [ 'completed', 'processing' ], true ) ) {
return;
}
// 可选：仅对特定支付网关生效（例如 bank transfer）
// if ( 'bacs' !== $order->get_payment_method() ) return;
$thank_you_url = wc_get_endpoint_url( 'order-received', $order_id, wc_get_page_permalink( 'checkout' ) );
?>
<script>
document.addEventListener('DOMContentLoaded', function() {
// 立即跳转（可选延迟：setTimeout(..., 2000) 表示2秒后跳转）
window.location.href = '<?php echo esc_js( $thank_you_url ); ?>';
});
</script>
<?php
}? 关键说明与注意事项：
- ✅
woocommerce_thankyou是唯一安全可靠的钩子：它仅在客户首次加载感谢页时执行，不干扰后台订单状态更新流程； - ? 使用
esc_js()对 URL 进行转义，防止 XSS 漏洞； - ⚠️ 不要使用
wp_redirect()或header('Location: ...')—— 此时响应头已发送，将导致“headers already sent”错误； - ? 若需兼容非标准感谢页（如自定义模板），请确保
$thank_you_url指向真实可访问的感谢页地址； - ? 如需埋点或统计跳转行为，可在
<script></script>中加入 GA4 或 GTM 事件（例如gtag('event', 'purchase', {...})）。
该方案简洁、稳定、符合 WordPress/WooCommerce 最佳实践，无需 AJAX 轮询或复杂状态监听，即可实现“订单变更为 completed 后，客户页面自动跳转至感谢页”的核心诉求。
