WooCommerce订单收到页订单ID始终显示0的问题如何解决？

故障参考 #

关联站点：www.cosmeto.tn

排查&修复步骤 #

• 第一步：排查主题模板冲突
  切换到WooCommerce官方默认主题Storefront测试，若问题消失则定位为当前主题问题。检查主题目录下woocommerce/checkout/thankyou.php文件，确认$order对象初始化逻辑正确，调用订单ID前增加对象有效性判断，标准输出逻辑参考：

  if ( is_a( $order, 'WC_Order' ) ) {
      echo esc_html( $order->get_id() );
  }
  

  删除模板中错误覆盖订单ID的自定义代码即可修复。
• 第二步：排查支付网关回调异常
  手动在订单收到页URL后追加?order_id=已存在的有效订单ID，若页面正常输出对应ID，即可确认是支付插件回调跳转时未正确传递order_id参数。修复支付网关的回调逻辑，支付完成后跳转感谢页时携带正确的订单ID参数即可。
• 第三步：排查插件冲突
  逐一禁用除WooCommerce外的第三方插件，定位是否有自定义插件、代码片段通过woocommerce_order_id、woocommerce_thankyou_order_id等过滤器错误返回0值，删除或修正错误的过滤逻辑。
• 第四步：排查缓存&会话问题
  检查服务器缓存、CDN、WordPress缓存插件的规则，确认/checkout/order-received/*路径未被缓存。同时检查WooCommerce会话存储配置，避免用户结账会话丢失导致无法匹配对应订单。

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