Magento2.4.3-p1提交发货后订单状态变更代码位置查询

你观察到vendor/magento/module-sales/Model/Order/Shipment.php的_saveShipment方法触发状态变更的结论是准确的，但状态变更逻辑并不直接写在该方法内部，是Magento2内置的订单状态流转规则+模型钩子机制共同触发的，具体链路如下：

核心流转链路 #

• 第一步：_saveShipment方法执行过程中，会先更新订单的已发货商品累计计数，如果你在后台提交发货时勾选了「自动生成发票」选项，会同时更新已开票金额累计计数
• 第二步：方法执行末尾会调用订单仓库的save()方法持久化订单数据，保存流程会自动触发订单模型内置的状态校验逻辑
• 第三步：状态校验逻辑位于vendor/magento/module-sales/Model/Order.php的_checkState()方法，这是状态变更的核心代码位置，核心判断规则如下：

// 订单状态自动流转核心判断片段
if (!$this->canShip() && !$this->canInvoice()) {
    $this->setState(self::STATE_COMPLETE)
         ->setStatus(self::STATE_COMPLETE);
}

其中canShip()会校验订单是否存在未发货的剩余商品，canInvoice()会校验订单是否存在未开票的剩余金额，两个判断同时返回false（即货已发完、票已开完）时，订单就会自动从Processing状态切换为Complete状态。

常见排查注意点 #

• 如果提交发货时没有勾选自动生成发票，原生逻辑下订单不会直接转Complete，会停留在Processing状态并标记为已发货
• 第三方ERP对接模块、订单自定义状态模块、支付模块经常会通过插件（Plugin）拦截_checkState()方法，或者监听sales_order_shipment_save_after事件改写默认状态流转规则，如果和原生逻辑表现不一致，可以先禁用相关自定义模块验证
• 调试时可以在_checkState()方法内临时打印调用栈，快速确认状态变更是原生逻辑触发还是第三方代码改写导致的。

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