class not found错误主因是psr-4加载链断裂，须严格校验入口引入顺序（vendor/autoload.php必须在base.php前）、composer.json中psr-4映射格式（如"app": "app/"）、执行composer dump-autoload -o、类文件路径与命名空间大小写完全一致。
ThinkPHP 8.0项目中类文件无法被new出来、报Class not found错误，绝大多数情况不是代码写错了，而是PSR-4自动加载没配对——命名空间声明、文件路径、composer.json映射、入口引入顺序这四者只要有一处不严丝合缝，整个加载链就断在第一步。
确认入口文件是否正确加载Composer自动加载器
打开 public/index.php，检查 require vendor/autoload.php 这行是否出现在所有其他 require 之前。
这一步不能错位：如果它在 require THINK_PATH . 'base.php';之后，ThinkPHP自己的Loader会先注册，后续Composer的PSR-4规则将被跳过，GuzzleHttpPsr7Request这类第三方依赖直接失效。
运行 【ls -l ./vendor/autoload.php】 确认该文件真实存在且可读；若项目根目录是 /var/www/myapp，而入口里写的是 ../vendor/autoload.php，实际路径应为 ../../vendor/autoload.php。
禁止使用 require_once 多次引入 autoload.php —— 同一请求中重复加载会触发 Cannot declare class 错误。
配置composer.json中的PSR-4映射
在项目根目录编辑 composer.json，确保顶层有 "autoload" 字段，且内部是合法JSON结构。
方法一：添加App命名空间映射
在 "autoload": {"psr-4": {}} 中加入 【"App\": "app/"】（注意双反斜杠，不是单斜杠也不是不加）。
方法二：添加多级命名空间映射
如需支持 Common 和 Extend，可扩展为：
"autoload": {
"psr-4": {
"App\": "app/",
"Common\": "common/",
"Extend\": "extend/"
}
}
路径值必须是相对于 composer.json 的子路径，不能写 ./app/ 或 ../app/；也不能漏掉末尾的斜杠，"App" 和 "app/" 缺一不可。
执行dump-autoload并验证类文件结构
第一步：运行 【composer dump-autoload -o】 —— -o 参数不可省，否则开发中常因缓存未更新导致“明明写了却找不到”。
第二步：检查类文件是否严格匹配映射规则。
例如命名空间 AppHttpControllersHomeController → 文件路径必须是 app/Http/Controllers/HomeController.php。
第三步：确认大小写完全一致。
Linux生产环境会因 Http 写成 http 或 HTTP 直接报错；类名 HomeController 不能写成 homecontroller 或 HomeController2；一个文件只允许定义一个类，且必须与文件名完全同名。
第四步：检查命名空间声明位置。
namespace 必须位于
动态类名调用必须用完全限定名
use AppModelsUser; 不会影响字符串拼接或变量解析的类名加载。
✅ 正确写法：
$u = new User(); // 静态写法，受 use 影响
$u = new AppModelsUser(); // 完全限定名，始终生效
❌ 错误写法：
$class = 'User'; $u = new $class(); // 此时 $class 被解析为当前命名空间下的类，与 use 无关
⚠️ 动态调用必须显式加反斜线前缀：$class = 'App\Models\User'; $u = new $class();
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
