类找不到主因是vendor/autoload.php未更新:Composer require默认自动dump-autoload,但若曾用--no-scripts或--no-autoloader则静默跳过;需检查autoload.php时间戳、映射内容及OPCache缓存。

为什么composer require后类还是找不到
不是包没装上,而是vendor/autoload.php没更新。Composer 默认会在require后自动执行dump-autoload,但一旦你之前用过--no-scripts或--no-autoloader,这步就静默跳过了。
实操建议:
- 运行
composer show get-stream/stream-chat(把包名换成你的)确认已安装 - 检查
vendor/autoload.php文件修改时间——如果比composer require命令还早,说明没刷新成功 - 别信“我刚装了”,要信时间戳和
vendor/composer/autoload_psr4.php里实际映射的内容
composer dump-autoload不生效的典型场景
执行了命令但报错依旧,大概率是参数没选对,或者环境没清理干净。默认的composer dump-autoload只更新静态映射,不碰classmap,也不处理autoload-dev里的路径——而这恰恰是 Laravel Service Provider、测试工具类、Factory 类常出问题的地方。
实操建议:
- 新增了
autoload-dev下的类(比如tests/Feature/ApiTest.php),必须加--dev:composer dump-autoload --dev - 移动或重命名过类文件(如把
app/Http/Controllers/UserController.php改成app/Controllers/UserController.php),要用-o强制重建classmap:composer dump-autoload -o - 部署后仍报错?可能是 OPCache 缓存了旧的 opcode,PHP 根本没读新生成的 autoload 文件,得清 OPCache 或重启 PHP-FPM
PSR-4 映射不生效:配置、路径、大小写三者缺一不可
哪怕只差一个反斜杠或一个大写字母,类就会“消失”。Composer 不做容错,它严格按composer.json里写的前缀和路径拼接文件系统路径,然后找文件。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
实操建议:
-
"App\": "src/"表示:类AppServicesUserService必须在src/Services/UserService.php,不能是src/services/userservice.php - Linux 下
UserService.php和userservice.php是两个文件,Windows 可能“凑合过”,一上生产立刻崩 - 检查
vendor/composer/autoload_psr4.php,搜索你的命名空间前缀,确认对应路径是否正确(例如:'App\' => array($baseDir . '/src')) - 别把类直接丢在
src/根目录下——PSR-4 要求子目录结构必须和命名空间层级一致
生产环境部署后Class not found却查不出原因
最隐蔽的坑是 OPCache 没清,而不是 autoload 文件没生成。即使vendor/autoload.php时间戳最新、autoload_psr4.php里映射也对,PHP 还可能在用旧的 opcode 缓存中的类路径。
实操建议:
- 部署脚本末尾加一句:
php -r "opcache_reset();"(前提是opcache.enable=1且opcache.revalidate_freq=0) - Apache + mod_php 环境下,仅重启 Apache 不一定生效,得确认 opcache 是否启用并显式重置
- 如果用了
composer install --no-dev --optimize-autoloader,记得它不会触发autoload-dev的刷新,测试类或 provider 类会直接“隐身”










