为什么 composer dump-autoload 后依然提示 Class not found？

Class not found 的根源在于类文件未被正确识别或路径配置错误，而非自动加载机制本身。1. 类名、命名空间与文件路径必须严格匹配，遵循 PSR-4 规范；2. composer.json 中的 autoload 配置需正确定义 psr-4、classmap 或 files 路径；3. 文件必须位于已声明的自动加载目录内，否则不会被扫描；4. OPcache 或环境差异可能导致旧缓存生效，需重启服务并确保 CLI 与 Web 环境一致。运行 dump-autoload 仅重建索引，不修复文件或配置问题。

执行 composer dump-autoload 后仍然提示 "Class not found"，通常不是自动加载本身的问题，而是类文件未被正确识别或路径配置有误。dump-autoload 只是重新生成映射关系，它不会修复源文件或配置的错误。

1. 检查类命名与命名空间是否匹配

PHP 类必须遵循 PSR-4 或 PSR-0 的命名规范。常见错误包括：

• 类名和文件名不一致（如类名为 UserHelper，但文件名为 user_helper.php）
• 命名空间声明错误或缺失
• 命名空间层级与目录结构不对应（如命名空间为 AppServices，但文件放在 src/helpers 目录下）

确保文件路径与命名空间完全匹配。例如：

// 文件路径：src/Services/UserService.php
namespace AppServices;

class UserService { }

登录后复制

2. 确认 composer.json 中的 autoload 配置正确

检查 composer.json 是否正确定义了自动加载规则，特别是 psr-4 或 classmap 配置。

示例（PSR-4）：

"autoload": {
    "psr-4": {
        "App\": "src/"
    }
}

登录后复制

修改后必须重新运行：

标签： php js json composer apache nginx app 解决方法 为什么