WooCommerce update_status更新订单状态缺少wc-前缀异常

核心结论 #

问题本质是钩子选择错误，代码触发时机过早，WooCommerce核心依赖逻辑未完成初始化

具体原因说明 #

• 你最初挂载的woocommerce_after_register_post_type钩子，触发节点仅完成了WooCommerce自定义文章类型（含订单shop_order类型）的注册，此时WooCommerce的订单状态注册、「内部状态值 -> 带wc-前缀的文章状态值」映射逻辑还未加载完成。
• 你排查到的set_status方法源码本身没有问题：该方法会先去除传入状态自带的wc-前缀，把纯状态名（比如completed）存在对象内部属性中；但最终写入数据库wp_posts表的post_status字段时，需要依赖提前注册好的映射规则自动拼接wc-前缀。如果映射规则未加载，程序会直接把不带前缀的纯状态名写入数据库，就出现了你看到的post_status = completed的异常值，不符合WooCommerce订单状态的存储规范，自然无法在后台订单列表被正常查询展示。
• add_order_note方法可以正常运行，是因为订单备注属于独立的shop_order_note自定义文章类型，写入逻辑不依赖订单状态映射规则，不受初始化时机影响。

钩子替换后正常的原因 #

你把挂载点换成init后代码可以正常运行，是因为init钩子触发时，WordPress核心、WooCommerce的基础核心逻辑（包括订单状态映射规则）已经完成加载，此时调用update_status可以正确拼接wc-前缀，把wc-completed写入数据库，订单就能在后台正常展示。

更稳妥的实践：做WooCommerce相关业务逻辑处理时，优先使用woocommerce_init钩子，该钩子是WooCommerce自身所有核心逻辑加载完成后专门触发的节点，能避免和WordPress核心、其他插件的初始化逻辑冲突，参考代码如下：

add_action( 'woocommerce_init', 'aapi_process' );
function aapi_process() {
  // 请替换为实际订单ID，示例中'order_id'为占位符
  $order = wc_get_order( '实际订单ID' );
  if ( ! $order ) {
    return;
  }
  $order->update_status( 'completed' );
  $order->add_order_note( 'My User Note', 1 );
}

内容的提问来源于stack exchange，提问作者David C. - ProServ