composer dump-autoload 后类仍找不到，主因是未清理旧缓存或配置错误；应加 -o 强制优化生成、-a 重扫 classmap、--dev 处理开发依赖，并检查路径、命名空间、大小写及 opcode 缓存。
composer dump-autoload 后类还是找不到
这通常不是命令没执行，而是 composer dump-autoload 默认只刷新自动加载规则，不清理旧的缓存文件（比如 vendor/composer/autoload_classmap.php 里残留的旧路径），尤其在你刚移动/重命名了类文件后更明显。
实操建议：
- 加
-o参数强制生成优化版映射：composer dump-autoload -o—— 它会重新扫描所有psr-4和classmap配置，覆盖旧文件 - 如果用了
classmap配置（比如包含src/下非标准命名空间的类），必须加-a才能重新扫描：composer dump-autoload -o -a - 确认
composer.json里的autoload或autoload-dev配置路径正确，比如写成"src/": "src/"而不是"src/": "src"（末尾斜杠影响实际解析）
require 了新包但新类无法被自动加载
Composer 安装包时默认会自动运行 dump-autoload，但如果你用 --no-autoloader、--no-scripts 或手动修改了 vendor/autoload.php，这个步骤就跳过了。
实操建议：
- 先检查是否漏掉自动加载触发：运行
composer install或composer update时不带--no-scripts - 如果确实需要跳过脚本，安装完立刻补上：
composer dump-autoload -o - 注意某些包（比如 Laravel 的 service provider）依赖
autoload-dev，而dump-autoload默认不处理 dev 配置，需显式加--dev：composer dump-autoload -o --dev
生产环境 autoload 文件更新后仍报 Class not found
常见于部署流程中只执行了 composer install --no-dev --optimize-autoloader，但没清空 OPCache 或 APCu 缓存，PHP 还在用旧的 opcode 缓存中的类路径。
实操建议：
- 部署后必须重启或刷新 PHP 的 opcode 缓存：
php -r "opcache_reset();"（前提是 opcache.enable=1 且 opcache.revalidate_freq=0） - 如果用的是 Apache + mod_php，重启 Apache 不一定生效，得确认 opcache 是否启用并重置
- 检查
vendor/autoload.php文件时间戳是否更新，如果没变，说明dump-autoload根本没跑成功，回退查前一步
autoload_classmap.php 里有类但 new 时仍失败
类名拼写、命名空间声明、文件路径三者必须完全一致。Composer 的 classmap 是静态路径映射，不校验命名空间与文件结构是否匹配，所以很容易“映射对了，但类本身写错了”。
实操建议：
- 用
composer show -p查看当前 classmap 映射结果，确认目标类是否在列表中，路径是否指向真实存在的文件 - 打开映射到的 PHP 文件，检查
namespace声明是否和use或new语句中的全限定名一致（比如new App\Services\Foo对应namespace App\Services;） - Windows 下注意大小写：classmap 会按文件系统原样记录路径，但 Linux 服务器上大小写敏感，
Foo.php和foo.php是两个文件
最常被忽略的是：dump-autoload 不解决语法错误、命名空间错位、文件权限问题——它只管“知道去哪找”，不管“找得到找不到”或“找得对不对”。遇到类找不到，先盯住 vendor/composer/autoload_classmap.php 里有没有那条映射，再顺藤摸到文件内容本身。
