Laravel如何配置Supervisor来持久化运行队列worker

使用Supervisor管理Laravel队列worker可确保其持久运行。1. 安装Supervisor并配置监听目录；2. 在/etc/supervisor/conf.d/下创建laravel-worker.conf，定义worker进程的命令、用户、日志等参数；3. 通过supervisorctl重载配置并启动进程；4. 查看日志文件和状态排查问题。配置后worker将自动重启，保障队列任务稳定执行。

在Laravel项目中，使用队列可以异步处理耗时任务，比如发送邮件、处理上传等。为了保证队列任务持续被消费，需要让队列worker长期运行。直接用php artisan queue:work启动的worker在进程退出或服务器重启后会停止，因此推荐使用Supervisor来监控和管理worker进程，确保其持久化运行。

1. 安装并配置Supervisor

Supervisor是一个进程管理工具，常用于Linux系统中监控后台进程。

安装Supervisor（以Ubuntu/Debian为例）：

安装完成后，Supervisor会自动启动并监听配置文件目录/etc/supervisor/conf.d/。

2. 创建Laravel队列Worker的Supervisor配置

在/etc/supervisor/conf.d/目录下创建一个配置文件，例如laravel-worker.conf：

填入以下内容（根据你的项目环境调整路径和用户）：

参数说明：

• command：运行的命令。建议加上--sleep=3避免频繁轮询，--tries=3设置最大重试次数，--max-time=3600表示worker运行一小时后自动重启，防止内存泄漏。
• numprocs：启动的worker进程数，可根据CPU核心数和任务负载调整。
• user：运行命令的系统用户，通常为web服务用户（如www-data）。
• stdout_logfile：日志输出位置，便于排查问题。
• stopwaitsecs：停止时等待时间，确保长任务完成后再杀进程。

3. 启动并管理Supervisor进程

保存配置后，重新加载Supervisor配置：

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

启动worker：

查看运行状态：

如果修改了配置，记得重新加载：

4. 日志与故障排查

如果队列任务未执行，先检查：

• 日志文件/var/log/laravel-worker.log是否有报错信息。
• 确认artisan命令路径是否正确。
• 确认PHP是否在系统路径中（可使用which php查看）。
• 确保队列驱动（如Redis、Database）正常运行。

Supervisor本身也有日志，默认位于/var/log/supervisor/supervisord.log，可用于排查进程异常退出原因。

基本上就这些。配置好Supervisor后，Laravel队列worker就能稳定持久运行，不再依赖手动启动。

以上就是Laravel如何配置Supervisor来持久化运行队列worker的详细内容，更多请关注php中文网其它相关文章！