PrestaShop 1.7.7.0 Cargo hookActionOrderStatusPostUpdate未触发

按问题出现概率排序的排查步骤 #

• 排查硬编码状态匹配逻辑错误
  当前代码直接判断$params['newOrderStatus']->id == 6，但PrestaShop的「已发货」状态ID并非固定值6，不同站点的安装配置、自定义状态规则、多店铺环境都会让这个ID产生变化，极有可能当前站点的已发货状态ID不等于6，导致代码分支完全没进入。
  修正方式：替换为对状态标识的稳定匹配，比如判断$params['newOrderStatus']->slug === 'shipped'，或直接读取系统内置的已发货状态配置值Configuration::get('PS_OS_SHIPPING')做比对，不要写死数字ID。
• 验证钩子是否真实触发
  在钩子方法的最开头加上本地日志输出代码，确认流程是否走到钩子内部：

  file_put_contents(
      _PS_ROOT_DIR_ . '/cargo_debug.log',
      date('Y-m-d H:i:s') . ' 钩子触发，参数: ' . print_r($params, true) . PHP_EOL,
      FILE_APPEND
  );
  

  完成后修改一次订单状态，查看站点根目录下的日志文件是否有内容：如果没有日志，说明钩子根本没有被绑定到执行流程里；如果有日志，再继续排查分支内的逻辑问题。
• 排查静默报错导致的执行中断
  PrestaShop后台默认隐藏PHP错误输出，代码中的异常不会在页面展示，会直接中断执行：
  • 代码中new Message((int)($order->id_message))这一行存在错误：Order类本身不存在id_message属性，传入无效的消息ID会触发类加载异常，直接中断后续流程，且无任何页面提示。
  • 拼接第三方API请求URL时，所有带空格、中文、特殊字符的参数没有做urlencode编码，会导致请求格式非法，触发PHP警告中断执行。
  • 获取国家、州省名称时没有指定当前语言ID，多语言场景下$country->name可能返回数组而非字符串，拼接字符串时会触发类型错误。
• 检查钩子注册状态
  如果之前安装过模块，后续修改了钩子注册逻辑，没有重新卸载安装模块，数据库里的钩子绑定记录会一直是旧配置，导致钩子不触发。可以到后台的钩子管理页面，找到actionOrderStatusPostUpdate钩子，确认Cargo模块在该钩子的已绑定模块列表中；如果不在，手动绑定模块后再测试。
• 排查执行超时问题
  调用第三方API时，如果第三方接口响应速度慢，会触发PHP执行超时限制，导致请求逻辑未完成就被系统终止，表现为修改订单状态后无任何推送响应。

注意：修复逻辑时，所有外部请求建议增加错误捕获和日志记录，不要依赖无提示的静默执行。

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