这种情况真的很让人头疼——明明逻辑看起来没问题，结果一边检测不到类，手动引入又提示类已存在，我之前也踩过类似的坑，大概率是这几个原因导致的，咱们一步步排查：

1. 最常见的坑：命名空间没写对 #

先打开Posts.php看看顶部有没有命名空间声明，比如：

<?php
namespace Project\Controllers;

class Posts {
    // 类内容
}

如果有命名空间，那你在Router.php里直接用class_exists('Posts')肯定检测不到！PHP的类识别依赖带命名空间的完整类名，必须用完整路径检测：

// 方式1：直接写完整命名空间
if (class_exists('Project\Controllers\Posts')) {
    // 逻辑代码
}

// 方式2：先use引入，再用::class获取完整类名
use Project\Controllers\Posts;
if (class_exists(Posts::class)) {
    // 逻辑代码
}

这时候手动引入提示类已存在，大概率是自动加载器已经悄悄加载过这个类，但你检测时用了短类名，导致匹配失败。

2. 自动加载器缓存搞鬼 #

如果你用Composer做自动加载，有时候缓存会拖后腿——自动加载映射没更新，导致class_exists找不到类，但实际类已经被加载。这时候跑个命令更新缓存就行：

composer dump-autoload

另外检查下composer.json的autoload配置是否正确，比如PSR-4映射：

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

要确保Project\命名空间对应app/Project/目录，这样自动加载器才能正确定位到Project\Controllers\Posts类。

3. 类被间接加载了 #

有时候你没手动引入Posts.php，但其他文件已经通过自动加载或require/include加载过它了，这时候手动引入就会提示重复，但class_exists因为类名写错（比如没带命名空间）检测不到。

你可以在检测代码前打印所有已加载的类，看看有没有Posts相关的：

// 在Router.php的检测逻辑前添加这段
foreach (get_declared_classes() as $class) {
    if (str_contains($class, 'Posts')) {
        var_dump($class);
    }
}

这样就能看到实际已加载类的完整名称，用这个名称去做class_exists检测就对了。

4. 大小写问题（Linux/macOS用户重点注意） #

如果你的服务器是Linux或macOS，文件名是严格区分大小写的！比如类名是Posts，但文件名是posts.php，自动加载器会因为不符合PSR-4规范找不到类，但你手动用require '../Controllers/posts.php'引入时，又会加载类导致重复报错。

这时候要把文件名改成Posts.php，和类名严格一致，检测时也要用正确的大小写类名。

额外小技巧：用class_exists的第二个参数排查 #

class_exists有个$autoload参数，默认是true会自动尝试加载类。你可以把它设为false，判断类是否已经被加载：

// 只检查已加载的类，不触发自动加载
if (class_exists('Project\Controllers\Posts', false)) {
    echo "类已经被加载了！";
} else {
    echo "类还没被加载，可能自动加载能找到？";
}

这能帮你快速区分是类没加载，还是检测时类名写错了。

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