结论：Workflow组件不能单独用composer install安装，必须通过symfony/framework-bundle或显式composer require symfony/workflow引入；装错版本或漏配YAML会导致状态机静默失效。
直接说结论：别用 composer install 装 Workflow 组件，它不单独发布，必须通过 symfony/framework-bundle 或 symfony/workflow 显式引入；装错版本或漏配 YAML 文件，状态机根本不会生效。
Workflow 组件不是“开箱即用”的独立包
很多人搜 “Composer 安装 Symfony Workflow”，以为像 monolog 那样直接 composer require 就完事。实际上：symfony/workflow 是个可选组件，但 Symfony 5.4+ 默认不启用，且它依赖 symfony/config、symfony/yaml 等基础能力，光 require 它本身没用。
- 正确做法是先确认项目已启用
FrameworkBundle（绝大多数 Symfony 应用都已启用） - 再执行
composer require symfony/workflow—— 这会拉取最新稳定版（如 6.4），但不会自动注册服务 - 若项目是旧版 Symfony（symfony/workflow 无法安装，必须升级或改用
symfony/console+ 手动状态管理
workflow.yaml 配置写错，状态机就等于没写
装完包只是第一步，Workflow 的定义必须放在 config/packages/workflow.yaml（路径不能错），否则容器里压根没有 state_machine.* 或 workflow.* 服务。
- 文件名必须是
workflow.yaml，写成workflows.yaml或state_machine.yaml都无效 - 顶层键名必须是
framework:→workflows:，不是workflows:直接顶格 - 每个 workflow 必须指定
type:（state_machine或workflow），漏掉会报The workflow "xxx" has no type defined - 示例最小可用配置：
framework:
workflows:
article_publishing:
type: state_machine
marking_store:
type: single_state
arguments: ['currentState']
supports: ['App\Entity\Article']
places: ['draft', 'review', 'published', 'archived']
transitions:
to_review: { from: 'draft', to: 'review' }
publish: { from: 'review', to: 'published' }
在实体里用 currentState 字段，类型和命名必须严格匹配
Workflow 不会自动读取 $status 或 $state，它只认你在 marking_store.arguments 里写的字段名，且该字段必须是字符串类型（不是枚举、不是 int）。
- 如果配置写了
arguments: ['currentState']，实体里就必须有public string $currentState = 'draft'; - 字段类型写成
private string $currentState没问题，但不能是protected $currentState且没 getter/setter —— Workflow 默认用反射读写，不走魔术方法 - 若用 Doctrine，字段需加
@ORM\Column(type="string")，不能是json或array类型，否则保存时会出错：Cannot convert value of type "array" to string
调用 transition 失败却不报错？检查 guard 表达式和事件监听器
执行 $workflow->apply($article, 'publish') 返回 false 却没异常，大概率是 guard 条件失败或监听器抛了静默异常。
- Guard 表达式（如
is_fully_reviewed()）返回false时，apply()直接返回false，不抛异常 —— 这是默认行为，得手动检查返回值 - 监听器（
workflow.article_publishing.entered_review）里如果用了未初始化的 service，可能触发 PHP Warning 但被吞掉，建议在监听器开头加throw new \LogicException('test');快速验证是否执行 - 调试命令：
bin/console debug:workflow查看所有注册的 workflow 及当前状态，比硬查 DB 更快
Workflow 的复杂点不在安装，而在配置与实体字段的耦合太紧——少一个冒号、错一个引号、字段类型不对，整个状态流转就静默失效。别信“装完就能跑”，每次改完 yaml 或实体，务必用 debug:workflow 和单元测试双重验证。
