Symfony后台任务需用Messenger组件异步执行：先配置异步传输，再创建消息与处理器类，控制器分发后启动消费者；生产环境须用systemd守护并设Restart=always，配合重试、失败传输及监控确保可靠性。
要让Symfony可靠执行耗时的后台任务（如发送批量邮件、生成报表、处理大文件），必须绕过HTTP请求生命周期限制，将任务从主请求线程中剥离，并确保其在脱离用户连接后仍能稳定运行。
用Messenger组件解耦任务
第一步：安装Messenger组件并启用异步传输
运行composer require symfony/messenger，然后在config/packages/messenger.yaml中配置异步传输，例如使用Doctrine作为消息队列：
复制AI写代码
1 2 3 4 5 6 7 8 9 10 11
framework:
messenger:
transports:
async:
dsn: 'doctrine://default?queue_name=async'
routing:
'App\Message\SendDailyReport': 'async'
这一步必须做——不配置transport，dispatch出去的消息只会被同步执行，起不到后台化作用。
第二步：创建消息类与处理类
执行php bin/console make:messenger-middleware或手动创建src/Message/SendDailyReport.php，仅定义属性；再创建对应处理器src/MessageHandler/SendDailyReportHandler.php，实现__invoke()方法。注意：处理器类必须声明为服务且带message_handler标签，否则Messenger无法识别。
第三步：在控制器中分发消息
注入MessageBusInterface，调用$bus->dispatch(new SendDailyReport($userId, $reportDate))。此时HTTP响应可立即返回，而实际处理延后进行。
启动消费者持续监听队列
开发环境直接运行：
php bin/console messenger:consume async --limit=10
该命令会拉取10条消息后退出，适合调试单次任务流。不要加--time-limit或--memory-limit除非你明确需要限制——默认无限制会导致进程长期驻留，占用内存。
生产环境必须用守护进程管理：
① 创建systemd服务文件/etc/systemd/system/symfony-messenger.service，内容包含User=www-data、WorkingDirectory=/var/www/myapp、ExecStart=/usr/bin/php /var/www/myapp/bin/console messenger:consume async --no-debug；
② 执行sudo systemctl daemon-reload && sudo systemctl enable symfony-messenger && sudo systemctl start symfony-messenger；
③ 检查状态：sudo systemctl status symfony-messenger，确认显示active (running)。
【必须设置Restart=always】否则消费者崩溃后不会自动重启，任务将永久积压。
配置重试与失败处理
方法一：启用内置重试策略
在messenger.yaml中为transport添加retry_strategy：
复制AI写代码
1 2 3 4 5 6 7
transports:
async:
dsn: 'doctrine://default?queue_name=async'
retry_strategy:
max_retries: 3
multiplier: 2
delay: 1000
这样第1次失败后等1秒重试，第2次失败后等2秒，第3次失败后进失败传输。
方法二：定义失败传输并启用失败处理命令
追加配置：
复制AI写代码
1 2 3 4 5 6 7 8 9 10 11 12 13
transports:
failed:
dsn: 'doctrine://default?queue_name=failed'
async:
...
failure_transport: failed
messenger:
failure_transport: failed
之后运行php bin/console messenger:failed:show可查看失败消息，php bin/console messenger:failed:retry可重新投递指定ID消息。
这一步不做，失败任务会直接消失，没有任何记录或恢复手段。
监控后台任务执行状态
安装Inspector Bundle一键接入可视化监控：
运行composer require inspector-apm/inspector-symfony，Bundle会自动注册。无需额外配置，所有通过Messenger dispatch的消息都会出现在Inspector仪表盘中，显示执行时间、内存峰值、SQL查询数和错误堆栈。
若不用第三方工具，至少启用Messenger内置统计：
在messenger.yaml中添加statistics: true，然后访问/_profiler/{token}?panel=messenger（需开启Profiler）查看最近消费记录。
不监控等于盲跑——你无法知道某条消息是否卡住、是否重复执行、是否因数据库死锁而停滞。
