Symfony Workflow本身不提供并发乐观锁，需结合Doctrine的@Version字段与事务控制实现：在apply()后flush()触发版本校验，捕获OptimisticLockException并重试或报错，确保状态变更原子性。
Symfony Workflow 本身不直接提供并发乐观锁机制，它是一个状态转换定义与校验工具，而非持久化或并发控制层。要在 PHP 8.5.7 中实现“带乐观锁的状态机”，需将 Workflow 与 Doctrine（或其他 ORM）的乐观锁能力结合使用——核心是让状态变更操作受数据库版本字段保护，并在 Workflow 的 apply() 流程中确保原子性校验。
用 Doctrine 实体版本字段支持乐观锁
Doctrine 原生支持乐观锁，通过 @Version 注解标记一个整数或时间戳字段。每次更新时，Doctrine 自动在 WHERE 子句中加入版本号比对；若版本不匹配（说明已被其他请求修改），则抛出 OptimisticLockException。
- 在实体中添加版本字段，例如：
private int $version = 0;，并用@Version @Column(type="integer")注解 - 确保该字段在数据库表中存在且默认为 0（整数类型推荐）
- Workflow 不感知版本字段，但你调用
$entityManager->flush()时，Doctrine 会自动检查
在 Workflow 应用逻辑中包裹事务与异常处理
不能只调用 $workflow->apply($subject, $transition) 就完事。必须将其放入显式事务，并捕获乐观锁异常，决定是否重试或提示冲突。
- 用
$entityManager->beginTransaction()开启事务 - 执行
$workflow->can($subject, $transition)校验合法性（非必需但推荐） - 调用
$workflow->apply($subject, $transition)—— 它会修改实体属性（如$subject->status），但不持久化 - 调用
$entityManager->flush()持久化，此时触发乐观锁校验 - 捕获
OptimisticLockException，可选择刷新实体后重试一次，或返回“状态已被修改”错误
避免 Workflow 内部状态与 DB 状态错位
Workflow 依赖实体当前属性值判断能否流转。如果多个请求并发读取了同一旧状态，都通过 can()，但只有第一个能成功 flush()，后续会因版本失败。这是预期行为，但需确保：
立即学习“PHP免费学习笔记（深入）”；
- 实体在进入流程前已从 DB 刷新（
$entityManager->refresh($subject)），尤其在长生命周期对象中 - 不要复用已 detached 或未同步的实体实例
- Workflow 配置中禁用
supports的宽松匹配（如避免用 getter/setter 模糊识别状态），确保状态字段真实反映 DB 值
可选：自定义工作流事件监听器强化一致性
利用 Workflow 的事件（如 workflow.entered、workflow.completed）做额外校验或日志，但注意：事件发生在内存操作阶段，不保证已持久化。真正需要强一致的地方（如发消息、调外部 API），应放在 flush() 成功之后。
- 监听
workflow.completed可记录审计日志，但日志内容应基于已 flush 的实体状态 - 若需在状态变更后触发异步任务，建议用延迟消息（如 Messenger）并在消费者中重新加载实体，避免使用过期内存对象
- 不要在事件中修改实体状态或再次调用
apply()，可能引发循环或状态混乱
