Laragon 本身不内置 RabbitMQ，需手动安装为 Windows 服务并启用管理插件；Laravel 通过 vladimir-yuldashev/laravel-queue-rabbitmq 扩展对接，需配置 .env 连接参数、注册服务提供器（Laravel 11）、发布队列配置，并用 queue:work 和管理界面验证消息收发。

Laragon 是 Windows 下轻量级本地开发环境，集成 Apache、Nginx、MySQL、Redis 等，也支持 RabbitMQ —— 但默认不自带。要在 Laragon 中让 Laravel 正常使用 RabbitMQ 做消息队列，关键不是“能不能”，而是**RabbitMQ 进程是否独立运行 + Laravel 是否正确对接**。 下面分三步说清实操要点，不绕弯、不假设你已装好所有东西：

一、在Laragon环境下启动RabbitMQ服务

注意：Laragon 不内置 RabbitMQ，需手动安装并作为 Windows 服务运行。

• 从 https://www.rabbitmq.com/install-windows.html 下载最新版 RabbitMQ Server（推荐 .exe 安装包）
• 安装时勾选 “Install RabbitMQ as a Windows service”（自动注册为系统服务）
• 安装完成后，打开 Laragon 主界面 → 点击右上角 “Services” → 找到 RabbitMQ 并启动（状态变绿）
• 验证是否就绪：浏览器访问 http://localhost:15672（默认管理界面），用账号 guest/guest 登录（首次需启用插件：rabbitmq-plugins enable rabbitmq_management）

二、Laravel项目配置RabbitMQ驱动

用的是主流扩展包 vladimir-yuldashev/laravel-queue-rabbitmq，Laravel 10/11 都适用，但细节有差异。

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

• 执行安装：composer require vladimir-yuldashev/laravel-queue-rabbitmq
• 在 .env 中写明连接信息（Laragon 本地常用默认值）：
  QUEUE_CONNECTION=rabbitmq
RABBITMQ_HOST=127.0.0.1
RABBITMQ_PORT=5672
RABBITMQ_VHOST=/
RABBITMQ_USER=guest
RABBITMQ_PASSWORD=guest
RABBITMQ_QUEUE=default
• Laravel 11 必须手动注册服务提供器：打开 config/app.php，在 providers 数组末尾加一行：
  VladimirYuldashev\LaravelQueueRabbitMQ\LaravelQueueRabbitMQServiceProvider::class,
• 确认 config/queue.php 的 connections.rabbitmq 配置存在且 driver 为 rabbitmq（新版包会自动发布配置，若无则执行：php artisan vendor:publish --provider="VladimirYuldashev\LaravelQueueRabbitMQ\LaravelQueueRabbitMQServiceProvider"）

三、测试队列是否真正跑通

别只信 php artisan queue:work rabbitmq 能启动，要验证消息能进能出。

• 创建一个简单任务：php artisan make:job TestRabbitMQJob，在 handle() 里写 info('RabbitMQ job executed at ' . now());
• 分发任务：TestRabbitMQJob::dispatch();（比如放在某个路由或命令中）
• 启动消费者：php artisan queue:work rabbitmq --verbose，观察控制台是否打印日志
• 进 RabbitMQ 管理页 → Queues → default → Get Messages，看是否有未消费消息；也可查看 Exchanges → amq.default → Publish message 测试直连发送

RabbitMQ 在 Laragon 下本质是独立 Windows 服务，Laravel 只是客户端。只要端口通、凭证对、驱动注册准，队列就能走通。不需要改 Laragon 核心配置，也不用动 Apache/Nginx。