应配置--memory参数(如--memory=128)使worker超限时自动退出,并结合Supervisor的autorestart=true实现重启;再叠加--max-jobs=500和--max-time=1800预防内存累积,辅以php -d memory_limit=192M兜底,高耗内存任务应路由至独立队列并设更高限额。

如果您在运行 Laravel 队列 worker 时遭遇进程因内存耗尽(OOM)被系统强制终止,则说明当前 worker 缺乏主动内存控制机制。以下是防止 OOM 的多种配置方法:
一、使用 --memory 参数限制单个 worker 进程内存上限
该参数直接作用于 artisan 命令,使 worker 在内存使用超过指定阈值(单位 MB)后,在当前任务执行完毕时自动退出,从而释放内存并为后续重启创造条件。
1、在终端中运行带内存限制的队列命令:
php artisan queue:work --memory=128
2、若需同时限制多个队列,可叠加 --queue 参数:
php artisan queue:work redis --queue=default,emails --memory=96
3、将该参数与 --tries 和 --timeout 组合使用,增强稳定性:
php artisan queue:work --memory=128 --timeout=60 --tries=3
二、通过 Supervisor 配置实现退出后自动拉起新进程
Supervisor 是生产环境管理 Laravel 队列进程的核心工具,它能捕获 worker 因 --memory 触发的正常退出,并立即启动新实例,避免服务中断。
1、编辑 Supervisor 配置文件(如 /etc/supervisor/conf.d/laravel-worker.conf)
2、确保配置中包含 autorestart=true 和 --memory 参数:
[program:laravel-worker]
command=php /var/www/myapp/artisan queue:work --memory=128 --sleep=3 --tries=3
autorestart=true
user=www-data
3、重载 Supervisor 配置并更新进程:
supervisorctl reread
supervisorctl update
supervisorctl start laravel-worker:*
三、结合 --max-jobs 和 --max-time 实现双重周期性重启
仅依赖内存阈值可能无法覆盖内存缓慢累积场景;--max-jobs 控制处理任务数,--max-time 控制总运行时长,二者可协同触发主动退出,预防长期驻留导致的内存泄漏。
1、设置 worker 每处理 500 个任务后重启:
php artisan queue:work --max-jobs=500
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
2、设置 worker 最长持续运行 1800 秒(30 分钟)后退出:
php artisan queue:work --max-time=1800
3、三者联用示例(推荐生产环境):
php artisan queue:work --memory=128 --max-jobs=500 --max-time=1800
四、在 PHP 层统一限制内存上限
通过 php -d 指令覆盖单个进程的 memory_limit,形成底层兜底防护,防止 artisan 命令绕过 --memory 参数或内部组件异常突破限制。
1、在 Supervisor 的 command 行中前置 php -d 设置:
command=php -d memory_limit=192M /var/www/myapp/artisan queue:work --memory=128
2、确认该设置未被 php.ini 全局值覆盖,且数值略高于 --memory 值以保留运行缓冲空间
3、必须确保 -d memory_limit 值不小于 --memory 参数值,否则 --memory 将失效
五、为专用队列通道单独配置内存策略
当存在高内存消耗型任务(如文件解析、图像处理)时,应将其路由至独立队列,并为该队列绑定更高但受控的内存限额,避免影响核心业务队列。
1、定义专用队列名(如 files),并在任务分发时显式指定:
dispatch(new ProcessLargeFile($path))->onQueue('files');
2、启动专属 worker 并设定差异化内存限制:
php artisan queue:work --queue=files --memory=256
3、禁止将 --memory=256 应用于 default 队列,以防低优先级任务拖垮整体资源水位

















