升级后 vendor 报 classnotfound 通常是因为类文件存在但自动加载映射缺失，运行 composer dump-autoload 可以重新生成 vendor/composer/autoload_classmap.php 修复此问题。该命令会扫描项目中的 psr-0、psr-4 命名空间及 classmap 配置，将类路径写入缓存文件。执行后需确保没有语法错误且权限正常，即可恢复类的自动加载。
为什么升级后自动加载失效
升级依赖包或修改了 composer.json 的 autoload 配置后，旧的缓存文件可能不再包含新添加的类或已移除的类。此时直接运行代码会触发 ClassNotFound 异常。dump-autoload 的作用就是根据当前的 composer.json 和 vendor 目录结构，重建这个映射关系。
{
"name": "example/app",
"autoload": {
"psr-4": {
"App\": "src/"
}
},
"require": {
"php": ">=8.0"
}
}
上述 composer.json 定义了 App 命名空间到 src/ 目录的映射。如果在此之后添加了新的类文件但未更新自动加载文件，就会报错。运行 composer dump-autoload 后，系统会遍历 src/ 下的所有 PHP 文件，将其类名与相对路径关联并写入 vendor/composer/autoload_classmap.php。例如，若 src/Service.php 中包含 class AppService，则映射表会增加 'AppService' => 'src/Service.php' 这一项。此后实例化该类时，Composer 的 autoloader 就能正确找到文件。
如何验证修复结果
修复完成后，可以通过简单的脚本来验证自动加载是否生效。创建一个测试脚本调用之前报错的类，观察是否能正常实例化而不抛出异常。这能确认 dump-autoload 生成的映射是否正确覆盖了所需的类。
<?php require_once __DIR__ . '/vendor/autoload.php';
try {
$service = new AppService();
echo "Class loaded successfully.";
} catch (Throwable $e) {
echo "Error: " . $e->getMessage();
}
这段代码引入了 Composer 的全局自动加载器，然后尝试实例化 AppService。如果之前的 ClassNotFound 问题是由自动加载映射缺失引起的，这里将输出 “Class loaded successfully.”。如果仍然报错，则说明可能存在拼写错误或目录结构不符合 PSR-4 规范。此外，还可以检查 vendor/composer/autoload_classmap.php 文件，确认其中是否包含了目标类的键值对。若文件为空或缺少相关条目，可能需要检查 composer.json 中的路径配置是否正确指向了包含类的目录。
基于 src/Service.php 的具体问题分析
假设在 src/Service.php 中定义了一个名为 AppService 的类，但在升级后无法被加载。这是因为升级过程可能清除了 vendor 目录或重置了自动加载缓存。通过运行 composer dump-autoload，Composer 会重新扫描 src/ 目录，发现 Service.php 文件，并将其注册到自动加载映射中。这样，当代码请求 AppService 时，Composer 就能定位到 src/Service.php 并加载它。如果 Service.php 中有依赖其他未加载的类，这些依赖也会在同一过程中被处理，前提是它们的命名空间和路径配置正确。
