PrestaShop 1.7.6自定义模块：订单状态变更后钩子未触发问题

问题分析 #

你这段代码循环修改订单状态时，偶发出现订单状态更新成功但hookActionOrderStatusPostUpdate钩子未触发的情况，核心原因集中在这几点：

• 重复执行保存操作：OrderHistory::addWithemail()方法内部已经完成了add()（包含save逻辑），后续手动调用save()会导致状态变更逻辑重复执行，干扰钩子触发的时机判断。
• Order对象实例缓存：循环中直接new Order($orderId)可能复用PrestaShop的对象缓存，导致current_state的判断不是最新值，甚至影响状态变更后的钩子触发上下文。
• 上下文缺失：批量操作时未明确设置店铺、语言等上下文，部分钩子触发依赖完整的环境上下文，缺失时会导致钩子不执行。

修正后的代码 #

foreach ($ordersIds as $orderId) {
    // 使用getById获取最新订单实例，规避对象缓存问题
    $order = Order::getById($orderId);
    if (!$order || (int)$order->current_state === (int)$newStatusId) {
        continue;
    }

    $history = new OrderHistory();
    $history->id_order = (int)$order->id;
    // 多店铺环境下明确绑定订单所属店铺
    $history->id_shop = (int)$order->id_shop;
    
    $history->changeIdOrderState((int)$newStatusId, $order);
    // addWithemail内部已包含save逻辑，且会触发钩子
    $history->addWithemail(true);
}

额外排查优化建议 #

• 临时禁用对象缓存：如果仍存在缓存导致的判断误差，可在循环前临时禁用对象缓存，循环结束后恢复：

  // 循环前禁用
  ObjectModel::$cache = false;
  
  // ...你的循环代码...
  
  // 循环结束后恢复
  ObjectModel::$cache = true;
  

• 添加钩子触发日志：在钩子实现中写入日志，方便排查偶发问题：

  public function hookActionOrderStatusPostUpdate($params) {
      $orderId = $params['id_order'];
      $newStatusId = $params['newOrderStatus']->id;
      file_put_contents(_PS_LOG_DIR_.'order_status_hook.log', "Order $orderId updated to status $newStatusId at ".date('Y-m-d H:i:s')."\n", FILE_APPEND);
  }
  

内容的提问来源于stack exchange，提问作者Daniel Krzyżanowski