在 Symfony 中注册 scheduler 任务需显式声明服务并打 scheduler.task 标签，实现 TaskInterface 或用 CommandTask 包裹命令，配置 schedule（cron/interval/fluent），注意环境加载、服务排除、参数格式、锁存储（避免 FileLockStore）以及时区一致。
如何在 Symfony 项目中注册一个可被 scheduler 执行的任务
Symfony 的 Scheduler 组件（v6.3+ 内置，v6.2 需装 symfony/scheduler）不靠注解或 YAML 自动扫描，任务必须显式注册为服务并打上 scheduler.task 标签。漏掉标签 = 任务永远不会被发现。
- 定义一个实现
Symfony\Component\Scheduler\Task\TaskInterface的类，比如SendReminderTask，或直接用CommandTask包裹已有命令 - 在
config/services.yaml中声明服务，并添加tags: [{ name: 'scheduler.task', schedule: '*/5 * * * *' }] -
schedule值支持 cron 表达式、interval（如'5 minutes'）、daily()等 fluent 方法（需用 PHP 配置） - 别在
dev环境默认启用调度器——它会常驻内存轮询，开发时建议用php bin/console scheduler:run --no-debug手动触发一次
运行 scheduler 时提示 “No tasks found” 或任务不执行
这不是 bug，而是环境或配置没对齐。最常见原因是：调度器只读取当前激活的 service configuration，而你的 task 服务可能被条件加载屏蔽了。
- 检查环境：运行
php bin/console debug:container --tag=scheduler.task --env=prod，确认 task 是否出现在列表里；dev下没列出来？说明它没被加载 - 确认服务未被
exclude：若 task 类放在src/Task/，但services.yaml里写了exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'，那Task/目录就进不去自动注册 - 避免用
bind:注入依赖到构造函数再传给CommandTask——CommandTask构造参数固定为string $command和array $arguments，多一个参数就会导致服务实例化失败，静默跳过
用 CommandTask 调用 console 命令时参数不生效
CommandTask 是最简方式复用已有命令，但它不会自动解析命令行参数语法（比如 --env=prod），所有参数都作为字符串原样传给 Application::find() 后的 run()，所以格式必须严格匹配命令定义的 InputDefinition。
- 错误写法：
new CommandTask('app:send-email --to=admin@example.com')→ 这会被当成一个命令名，找不到 - 正确写法：
new CommandTask('app:send-email', ['--to' => 'admin@example.com']) - 布尔选项（如
--force）要写成['--force' => true]，不能只写['--force']（PHP 数组不支持纯字符串键值对这种简写） - 如果命令本身有必填参数（如
app:process:user {id}），必须提供键名id，否则抛MissingValueException
生产环境部署后任务延迟或重复执行
因为 Scheduler 默认使用 FileLockStore 做并发控制，而 NFS 或某些容器共享卷不支持可靠文件锁。单机没问题，一上 K8s 或多实例就出问题。
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖默认锁机制：改用
RedisLockStore（需安装symfony/lock+ Redis DSN）或数据库锁（PdoLockStore） - 确保所有调度进程共用同一套锁存储——哪怕你启了 3 个
php bin/console scheduler:consume进程，它们也得连同一个 Redis 实例 -
consume命令默认每 1 秒轮询一次，高频率 + 多实例 + 文件锁 = 大量无效竞争。换成 Redis 后可安全调低间隔（如--sleep=0.1） - 注意时区：服务器时区、PHP
date.timezone、cron 表达式解释器（CronExpression）三者不一致会导致“明明设了 9:00 却 17:00 执行”
真正麻烦的是锁和时区这两个点，其他都能靠 debug 命令看出来，但这俩出问题时现象很模糊——任务像抽风一样有时跑有时不跑，查日志还全是成功的。
