自定义Sylius sylius_order状态机：新增转义无法通过代码获取

我之前在自定义Sylius订单状态机的时候也碰到过一模一样的问题——debug命令能看到完整的状态图，但代码里调用getPossibleTransitions()就是拿不到新增的转换。给你几个排查和解决的方向：

1. 确认状态机配置的合并方式 #

首先检查你的状态机配置是不是正确合并到了默认的sylius_order状态机里，而不是重新定义了整个状态机。错误的配置会导致新增转换没被加载，甚至覆盖默认逻辑。

正确的配置示例（建议放在config/packages/sylius_order.yaml）：

winzou_state_machine:
    sylius_order:
        # 新增validated状态
        states:
            validated: ~
        # 新增new到validated的validate转换
        transitions:
            validate:
                from: [new]
                to: validated
        # 如果需要回调逻辑，在这里添加（可选）
        callbacks:
            after:
                validate_order:
                    on: [validate]
                    do: ['@your.custom.service', 'handleOrderValidation']
                    args: ['object']

如果你的配置是重新写了整个sylius_order节点，会覆盖Sylius默认的状态和转换，这时候即使debug命令显示正确，实际运行时也会出现异常。

2. 验证状态机服务与订单状态 #

确保你在代码中正确获取了sylius_order状态机，并且订单确实处于new状态：

// 正确获取状态机服务
$stateMachine = $this->get('winzou_state_machine.factory')->get($order, 'sylius_order');

// 先确认订单状态是否为'new'
dump($order->getState()); // 必须输出'new'才会显示validate转换

// 再获取可用转换
$transitions = $stateMachine->getPossibleTransitions();
dump($transitions);

另外要注意状态机名称的拼写是sylius_order，别写错成slius_order之类的低级错误。

3. 排查状态机守卫/拦截器 #

Sylius本身或者你的自定义代码可能添加了状态机守卫（Guard），这些逻辑会根据订单的业务条件过滤可用转换。比如默认的订单状态机里，fulfill转换需要订单已付款，你的validate转换可能被某个守卫拦截了。

可以检查是否有监听winzou_state_machine.pre_transition事件的代码，或者查看状态机配置里的guards节点，看看有没有针对validate转换的限制逻辑。

4. 清除缓存并验证容器配置 #

有时候开发环境的缓存会导致配置没有更新，执行以下命令清除缓存：

php bin/console cache:clear --env=dev

然后通过容器调试命令确认状态机配置是否正确加载：

php bin/console debug:container winzou_state_machine.machine.sylius_order

在输出里找到states和transitions部分，确认validated状态和validate转换存在。

5. 检查配置加载顺序 #

如果你的配置是放在自定义Bundle里，要确保Bundle的加载顺序在SyliusCoreBundle之后。可以在你的Bundle类的getDependencies()方法里设置：

public function getDependencies()
{
    return [
        new BundleDependency(Bundle::DEPENDENCY_TYPE_REQUIRES, SyliusCoreBundle::class),
    ];
}

这样能保证你的状态机配置在Sylius默认配置之后加载，避免被覆盖。

按照这几个步骤排查下来，应该能找到问题所在。我当时是因为配置文件放错了位置，导致没有合并到默认状态机里，调整配置位置后就正常了。

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