当 Composer 成功安装依赖但 PHP 仍报“类未找到”（如 GetStream\StreamChat\Client）时，通常是因为自动加载映射未更新，需执行 composer dump-autoload 或优先使用 composer require 触发自动注册。
当 composer 成功安装依赖但 php 仍报“类未找到”（如 `getstream\streamchat\client`）时，通常是因为自动加载映射未更新，需执行 `composer dump-autoload` 或优先使用 `composer require` 触发自动注册。
在 Laravel 7.0（PHP 7.2，Ubuntu 18.04.4）等环境中，即使 composer install 显示包已下载并出现在 vendor/ 目录下，仍出现 Class 'GetStream\StreamChat\Client' not found 错误，根本原因并非安装失败，而是 Composer 的自动加载机制未将新包的命名空间正确注册到 vendor/autoload.php 中。
这通常发生在以下场景：
- 直接修改 composer.json 后仅运行 composer install（而非 composer update 或 composer require）；
- 项目使用了自定义 PSR-4 映射但未同步更新 autoload 配置；
- vendor/autoload.php 缓存未刷新，导致类加载器无法定位新增命名空间。
✅ 正确做法是优先使用 composer require 安装包，它会自动完成三件事：
① 将依赖写入 composer.json；
② 下载包至 vendor/；
③ 实时更新 vendor/composer/autoload_psr4.php 等映射文件，确保命名空间可被识别。
# 推荐：一步到位，安全可靠 composer require get-stream/stream-chat # 若已手动安装但类仍不可用，强制重建自动加载映射 composer dump-autoload
⚠️ 注意事项：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 不要仅靠 composer install 添加新包——它只读取 composer.lock 安装已有依赖，不会解析 composer.json 新增项；
- composer dump-autoload 支持参数优化：如 composer dump-autoload --optimize 可生成更高效的类映射（适用于生产环境）；
- 检查 composer.json 中是否意外删除了 "autoload": {"psr-4": {...}} 配置，或存在语法错误；
- 在 Laravel 中，确保未误删 vendor/autoload.php 的引入（通常位于 public/index.php 和 artisan 文件头部）。
最后，验证是否生效：
// 在 Laravel 控制器或 Tinker 中测试
use GetStream\StreamChat\Client;
$client = new Client('your_api_key', 'your_api_secret');
dd($client instanceof Client); // 应返回 true总结：Composer 的自动加载是 Laravel 类发现的核心机制。遇到 “Class not found”，第一反应不应是重装包，而应检查 autoload 是否同步——composer require + dump-autoload 是最稳妥的标准化流程。
