PHP：PSR-4自动加载下Class 'LoginController'未找到问题求助

开发者阿泽

2026-5-19

排查PSR-4自动加载找不到LoginController的问题

遇到这种情况不用慌，咱们从PSR-4的核心规则出发，一步步排查可能的问题：

1. 命名空间是否与文件路径严格匹配

PSR-4的核心逻辑是命名空间对应目录结构，你的文件路径是/app/Controllers/Frontend/Guest/LoginController.php，那文件内的命名空间必须严格对应：

<?php
// LoginController.php 开头必须写对命名空间
namespace Controllers\Frontend\Guest;

class LoginController
{
    // 你的控制器方法
}

注意命名空间的层级：Controllers对应app/Controllers目录，Frontend对应子目录Frontend，Guest对应子目录Guest，完全一一对应才行。

打开项目根目录的composer.json，找到autoload下的psr-4节点，必须正确映射命名空间前缀到目录路径：

{
    "autoload": {
        "psr-4": {
            "Controllers\\": "app/Controllers/"
        }
    }
}

这里要注意两个关键点：

命名空间前缀末尾的反斜杠不能少："Controllers\\"（JSON里要转义，所以写两个反斜杠），如果写成"Controllers"会导致映射错误。
目录路径要和实际位置匹配：如果你的composer.json在项目根目录，app/Controllers/是正确的（相对路径），如果不在根目录，要调整为正确的相对路径。

修改完composer.json或者新增文件后，composer的自动加载缓存不会自动更新，必须执行以下命令刷新：

composer dump-autoload

这个命令会重新生成vendor/autoload.php相关的自动加载文件，清除旧的缓存记录。

Linux/macOS系统是区分文件名大小写的，Windows虽然不区分，但部署到生产环境（一般是Linux）会出问题。必须保证：

文件名是LoginController.php（首字母大写，和类名完全一致）
类名是LoginController（和文件名完全匹配，包括每个字母的大小写）
如果文件名写成logincontroller.php或者Logincontroller.php，都会导致PSR-4找不到类。

你代码里用$class = new $class();，要确保$class变量的值是完整的带命名空间的类名，比如：

$class = 'Controllers\\Frontend\\Guest\\LoginController';
$instance = new $class();

如果只写'LoginController'，PHP会在当前命名空间下查找，自然找不到。如果是用use导入的话，要确保导入语句正确：

use Controllers\Frontend\Guest\LoginController;

$instance = new LoginController();

仔细核对文件路径：/app/Controllers/Frontend/Guest/LoginController.php，有没有拼写错误？比如：

把这些点逐一排查，基本就能解决PSR-4自动加载找不到类的问题了。

内容的提问来源于stack exchange，提问作者guziba