PHP静态调用提示未找到类_PHP类名拼写与自动加载排查【解答】

class ‘XXX’ not found 错误90%因类名拼写错误、大小写不匹配、autoload未覆盖路径或缓存未更新；需检查类名/文件名一致性、use语句、composer.json映射、dump-autoload及opcache缓存。

静态调用报错 Class 'XXX' not found，90% 是类名拼写错误或自动加载没覆盖到路径，不是 php 版本或语法问题。

类名大小写和文件名是否严格匹配

PHP 在 linux/macos 下区分类名大小写，也区分文件名大小写。哪怕只错一个字母或大小写不一致，new XXX() 或 XXX::method() 都会触发 Class 'XXX' not found。

• 检查 use 语句里的类名：比如写了 use AppModelsuser;，但实际类是 User（首字母大写）→ 错
• 检查 composer.json 中的 autoload 配置是否映射了对应命名空间路径
• 确认类文件名是否与类名完全一致：类 HelperTool 必须存为 HelperTool.php，不能是 helper_tool.php 或 helpertool.php

Composer 自动加载没生效或配置错误

没运行 composer dump-autoload，或 psr-4 映射路径写错，会导致类找不到——即使文件存在、类名正确。

• 检查 composer.json 中的 "autoload": {"psr-4": {"App\": "app/"}} 是否指向真实目录（注意结尾斜杠和反斜杠差异）
• 确保类文件在映射路径下，且命名空间与目录结构一致：例如 AppModelsUser 必须放在 app/Models/User.php
• 修改完 composer.json 后，必须执行 composer dump-autoload -o（加 -o 生成优化后映射）
• 开发中临时测试可加一句 require_once __DIR__ . '/path/to/YourClass.php';，绕过 autoloader 排查是否纯加载问题

静态调用时用了错误的类上下文

写 SomeClass::doSomething() 之前，得先确保 SomeClass 已被加载，且不是在未声明命名空间的文件里误用了带命名空间的类名。

立即学习“PHP免费学习笔记（深入）”；

• 如果在全局命名空间文件中调用 AppModelsUser::find(1)，没问题；但如果当前文件有 Namespace Admin;，又没写 use AppModelsUser;，就会报错
• 别依赖“之前某个地方 new 过它就自动可用”——静态调用不触发实例化，也不隐式加载
• 用 class_exists('AppModelsUser') 或 get_declared_classes() 打印验证类是否真被加载

最常被忽略的是：改了类名或移动了文件后，忘了删 vendor/composer/autoload_classmap.php 里的旧缓存项，或者用的是 APCu/opcache 缓存了旧的 autoloader 映射——这时候清缓存比重写代码更有效。