Laravel 9 中 database 驱动稳定消费任务需确保表结构、配置、进程管理、失败处理四者严丝合缝：必须运行 queue:table 和 queue:failed-table 迁移建表，正确配置 QUEUE_CONNECTION=database 并清缓存，用 Supervisor 守护 worker 进程，任务类须实现 ShouldQueue 且构造函数仅传简单类型。
用 database 驱动在 Laravel 9 中稳定消费任务，关键不是“装上就能跑”，而是让表结构、配置、进程管理、失败处理四者咬合严实。它适合中小流量、无 Redis 环境或快速验证场景，但若忽略细节，容易出现任务卡住、重复执行、日志缺失等问题。
确保 jobs 和 failed_jobs 表已就位
database 驱动完全依赖这两张表，缺一不可，且必须由 Laravel 官方命令生成：
- 运行
php artisan queue:table—— 生成jobs表迁移（存储待执行任务） - 运行
php artisan queue:failed-table—— 生成failed_jobs表迁移（记录失败任务，用于重试和排查） - 执行
php artisan migrate—— 真正建表；别用migrate:fresh，线上慎操作 - 检查
config/queue.php中connections.database.table值是否为'jobs'（默认值，但手误改过就失效）
正确配置 .env 与 config 文件
QUEUE_CONNECTION=database 是开关，但仅此不够：
- .env 中确认只写
QUEUE_CONNECTION=database，不要写成数据库名或自定义字符串（如QUEUE_CONNECTION=mydb会静默降级为 sync） - 检查
config/queue.php的connections.database块是否完整存在（Laravel 9 默认已内置） - 修改 .env 后，务必运行
php artisan config:clear（开发环境），否则 Laravel 仍读缓存里的 sync 配置 - 进
tinker验证：config('queue.default')返回"database"才算生效
启动并守护 worker 进程
php artisan queue:work 是前台命令，关终端就停——这不是稳定消费，只是临时测试：
- 本地调试可加参数：
php artisan queue:work --verbose --delay=3 --tries=3，看日志、防卡死、自动重试 - 生产环境必须用 Supervisor 管理：设
autostart=true、autorestart=true、numprocs=2（双 worker 提升吞吐） - Supervisor 配置中
command必须带database参数：php artisan queue:work database，不能省略 - 避免用
nohup或&后台运行，缺乏崩溃恢复和日志归集能力
任务类与分发需满足硬性要求
哪怕表和配置全对，任务本身不合规，也会导致“调了 dispatch 却没进 jobs 表”：
- 任务类必须
implements ShouldQueue（Laravel 9make:job默认已加，但复制旧类或手写易漏） - 构造函数里只传简单类型（int、string、array、Eloquent 模型 ID），不能传 Request、UploadedFile、DB 实例或闭包
- 分发时别误用
dispatchNow()——它是同步执行，不走队列，调试时容易混淆 - 需要延迟执行？用
->delay(now()->addMinutes(10))，别在__construct里计算时间戳
database 驱动不复杂，但容易忽略表迁移顺序、配置缓存刷新、worker 守护机制这些衔接点。稳住这四块，任务就能持续、可追溯、可重试地消费下去。
