Composer PSR-4自动加载异常求助：配置后无法运行并报错

嘿，我太懂这种配置完PSR-4却跑不起来的挫败感——我之前也踩过好几个一模一样的坑！咱们一步步来排查，大概率是几个容易忽略的细节没做好：

1. 先核对文件结构和PSR-4配置的匹配度 #

PSR-4的核心逻辑就是命名空间和目录结构严格对应，举个最常见的正确示例：
假设你的composer.json配置是这样的：

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

那你的类文件必须放在src/目录下，且命名空间要和子目录完全对应。比如你的greeting.php如果属于MyApp\Utils命名空间，那文件路径必须是src/Utils/Greeting.php（注意大小写！），绝不能随便扔在根目录或者其他不匹配的路径里。

2. 检查类文件的命名空间和类名细节 #

这是最容易踩的坑：

• 类文件开头的命名空间必须和composer.json的前缀、目录结构完全一致，比如上面的例子，Greeting.php里得这么写：

<?php
namespace MyApp\Utils;

class Greeting { // 重点！类名必须和文件名完全一致（包括大小写）
    public function sayHello() {
        return "Hey there!";
    }
}

• PSR-4强制要求文件名和类名严格匹配，比如类是Greeting，文件就得叫Greeting.php，如果写成全小写的greeting.php，Linux系统下直接报错，Windows虽然不敏感，但也会埋下隐患。

3. 确认入口文件正确引入自动加载文件 #

你的index.php开头必须引入Composer生成的自动加载文件，路径要确保正确：

<?php
// 这里的路径要根据index.php的位置调整，比如如果在子目录就写成../vendor/autoload.php
require __DIR__ . '/vendor/autoload.php';

use MyApp\Utils\Greeting;

$greet = new Greeting();
echo $greet->sayHello();

要是不确定路径对不对，可以加一行var_dump(file_exists(__DIR__ . '/vendor/autoload.php'));验证文件是否存在。

4. 别忘了执行composer dump-autoload #

每次修改composer.json或者调整文件结构后，必须运行这个命令让Composer重新生成自动加载映射文件，不然新配置根本不会生效。直接在终端跑：

composer dump-autoload

嫌麻烦可以简写：composer dump

5. 根据报错精准定位问题 #

如果报错是Class "XXX" not found，对应排查：

• 是不是命名空间写错了？比如漏了前缀或者目录和命名空间不对应
• 是不是文件名和类名不匹配？
• 是不是composer.json有语法错误？可以用composer validate命令验证配置文件合法性

要是还是解决不了，把你的composer.json内容、文件结构、类文件代码贴出来，我帮你精准找茬！

内容的提问来源于stack exchange，提问作者Václav Stummer