Class not found 错误主因是 composer.json 中 autoload 配置（如 "App": "src/"）与实际文件路径、命名空间不匹配，或 vendor/autoload.php 未被正确加载；需检查映射一致性、执行 composer dump-autoload -o，并确保入口文件首行动态引入 autoload.php。
composer dump-autoload 报错：Class not found 或 autoload.php 无法加载
直接执行 composer dump-autoload 却报 Class not found，大概率不是命令本身出问题，而是自动加载配置（composer.json 中的 autoload 或 autoload-dev）与实际文件结构不一致。比如声明了 PSR-4 映射 "App\": "src/"，但 src/ 下根本没有 App/ 子目录，或类文件命名/命名空间不匹配。
实操建议：
- 检查
composer.json的autoload段，确认路径存在且可读：ls -l src/、ls -l app/ - 核对类文件的命名空间是否与目录结构严格对应（如
namespace AppControllers;→ 必须在src/Controllers/下） - 临时删掉
vendor/autoload.php和vendor/composer/autoload_*.php，再运行composer dump-autoload -vvv看详细错误位置 - 若用的是 classmap，确保目标目录里确实有 PHP 文件，且不含语法错误（
php -l file.php可单个验证）
composer install / update 后 autoload.php 仍不生效
常见于开发环境切换（如从 Git 拉新分支）、或手动修改过 vendor/ 目录。Composer 不会自动重写 vendor/autoload.php，它只是引导文件，真正逻辑在 vendor/composer/ 下的生成文件中。
实操建议：
- 不要手动编辑
vendor/autoload.php—— 它每次install/update都会被覆盖 - 确认当前项目根目录下存在
vendor/composer/autoload_static.php（或autoload_classmap.php等），若缺失，说明dump-autoload未成功完成 - 强制重建全部 autoload 文件：
composer dump-autoload --optimize --classmap-authoritative（仅生产环境推荐加--classmap-authoritative） - 如果项目用了 Composer 插件（如
hirak/prestissimo），尝试禁用后重试：composer global disable hirak/prestissimo
PSR-4 映射生效但子命名空间类找不到
例如配置了 "App": "src/"，AppHttpControllerHomeController 找得到，但 AppHttpMiddlewareAuthMiddleware 报错 —— 很可能 src/Http/Middleware/ 目录不存在，或文件名不是 AuthMiddleware.php（大小写敏感，尤其 Linux 环境）。
实操建议：
- PSR-4 是「命名空间前缀 → 目录」映射，后面部分必须逐级对应真实路径，不能靠自动补全
- 用
composer show --platform确认当前 Composer 版本，2.x 对路径校验更严格；1.x 可能静默忽略某些错误 - 运行
composer dump-autoload -d（debug 模式）查看是否输出类似Skipping invalid directory "src/Http/Middleware" - Windows 开发者注意：Git 默认不区分大小写，
git config core.ignorecase false并重新克隆可暴露路径大小写问题
autoload.php 被 require 但提示 “No such file or directory”
这通常不是 Composer 问题，而是代码里写了硬编码路径，比如 require 'vendor/autoload.php';，但当前工作目录不是项目根目录（如 CLI 进入子目录执行，或 Web 服务器 DocumentRoot 设在 public/ 下却没切到项目根目录）。
实操建议：
- 永远用相对项目根目录的方式加载：
require __DIR__.'/../vendor/autoload.php';（__DIR__指当前文件所在目录） - Web 入口（如
public/index.php）应确保chdir()到项目根，或用dirname(__DIR__)定位 vendor - CLI 脚本开头加
chdir(dirname(__DIR__));再 require，避免依赖执行位置 - 检查
vendor/是否被 .gitignore 忽略导致未拉取 ——ls -la vendor/autoload.php最快验证
autoload 的核心就两点：配置和文件结构必须咬合，加载路径必须动态可靠。最常被忽略的是工作目录影响和大小写敏感性，尤其是跨平台协作时。
