使用Supervisor运行Laravel队列任务时遇Could not open input file: /path/artisan错误求助

核心排查与修复步骤 #

• 指定工作目录：在Supervisor配置文件中添加directory项，指向你的Laravel项目容器内的根目录，比如directory=/var/www/html。Supervisor默认工作路径可能不是项目根目录，这会导致即使命令里写了artisan绝对路径也可能解析异常。
• 验证绝对路径准确性：不要使用占位符/path/artisan，在容器内执行pwd确认项目根路径，执行which php确认PHP可执行文件路径，把这两个路径组合成完整命令，比如/usr/bin/php /var/www/html/artisan queue:work。
• 检查配置文件权限：确保Supervisor配置文件（通常在/etc/supervisor/conf.d/下）的用户权限正确，避免因权限问题无法读取路径。

完整的Supervisor配置示例 #

[program:laravel-queue-worker]
process_name=%(program_name)s_%(process_num)02d
# 替换为你容器内的PHP路径和项目路径
command=/usr/bin/php /var/www/html/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
# 项目根目录
directory=/var/www/html
autostart=true
autorestart=true
# 替换为你的项目运行用户，比如www-data
user=www-data
numprocs=4
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/worker.log
stopwaitsecs=3600

替代实现方案 #

• Laravel Horizon：官方提供的队列管理工具，自带进程监控与自动重启功能，无需手动配置Supervisor，还支持可视化面板查看队列状态、失败任务等，适合生产环境使用。安装后只需配置config/horizon.php，执行php artisan horizon即可启动。
• Docker Compose 自重启策略：如果是Docker部署，直接在docker-compose.yml中给队列服务添加restart: always，无需依赖Supervisor：

services:
  queue-worker:
    build: .
    command: php artisan queue:work redis --sleep=3 --tries=3
    restart: always
    volumes:
      - .:/var/www/html
    depends_on:
      - redis
      - app

队列性能优化建议 #

• 合理设置进程参数：
  • --sleep=3：无待处理任务时进程休眠3秒，降低CPU占用
  • --tries=3：任务失败后重试3次，避免无限重试
  • --max-time=3600：进程运行1小时后自动重启，防止长期运行导致内存泄漏
• 拆分队列类型：将不同业务类型的任务（如邮件发送、数据同步）分配到不同队列，单独启动进程处理，避免单个队列阻塞影响其他任务
• 启用失败任务跟踪：执行php artisan queue:failed-table生成失败任务表，配合php artisan queue:retry命令重试失败任务，同时可配置邮件通知监控失败情况

内容的提问来源于stack exchange，提问作者tinox