根本原因是php-amqplib未成功安装或autoloader失效：需执行composer require php-amqplib/php-amqplib:^3.0，确认vendor目录存在且php -m含bcmath/sockets扩展，再运行composer dump-autoload -o。
根本原因不是 Laravel 配置问题，而是 php-amqplib 扩展根本没装成功，或者自动加载失效。
composer require php-amqplib/php-amqplib 没执行或失败
这是最常见的情况：你写了代码里用了 PhpAmqpLibConnectionAMQPStreamConnection，但项目里压根没引入这个库。
- 检查
vendor/php-amqplib/php-amqplib目录是否存在 —— 不存在就说明没装 - 运行
composer show php-amqplib/php-amqplib，如果报 “Package not found”，就是没装 - 别只复制别人代码里的
use语句，use不会自动拉包，必须composer require - 执行
composer require php-amqplib/php-amqplib:^3.0（Laravel 8+ 推荐用 3.x；2.x 已停止维护）
装了但 autoloader 没生效（尤其在 Docker 或部署后）
本地 composer install 成功，但线上或容器里跑起来报错，大概率是 autoload 缓存没更新或 vendor 权限异常。
- 删掉
vendor/autoload.php和composer.lock，重新composer install --no-dev - 强制重生成自动加载：
composer dump-autoload -o - Docker 环境注意：
vendor是否被 volume 覆盖？是否在构建镜像时漏掉了composer install步骤？ - 检查
composer.json的"autoload"配置有没有意外覆盖了默认 PSR-4 规则
用了 laravel-queue-rabbitmq 却手动 new AMQPStreamConnection
如果你已通过 composer require vladimir-yuldashev/laravel-queue-rabbitmq 接入 Laravel 原生队列系统，就不该再自己实例化 AMQPStreamConnection —— 这会造成配置割裂和重复初始化。
- 该扩展内部已封装连接逻辑，你只需配好
config/queue.php里的rabbitmqconnection - 发任务统一走
dispatch(new YourJob)或Bus::dispatch()，不要手写 publish - 手写连接容易忽略 vhost、SSL、心跳等关键配置，出错时反而更难定位
- 若真要手写连接（比如做管理操作、非队列场景），确保
use PhpAmqpLibConnectionAMQPStreamConnection;上方没有拼写错误（比如大小写、反斜杠漏掉）
最容易被忽略的一点：php-amqplib 依赖 ext-bcmath 和 ext-sockets，某些精简版 PHP（如 Alpine 容器、部分宝塔环境）默认不带。运行 php -m | grep -E 'bcmath|sockets' 确认这两个扩展已启用 —— 缺一个，AMQPStreamConnection 类照样不会被加载。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
