必须引入vendor/autoload.php并配置psr-4映射，运行composer dump-autoload -v验证扫描路径，清理缓存后检查autoload_psr4.php中appservice映射是否正确，确保文件路径、命名空间、类名严格一致且大小写敏感。
刚跑通ThinkPHP项目却在控制器里new一个类就报Class not found，文件明明放在app/service/下、命名空间也写了appserviceUserService，但就是加载不出来——这问题90%不是代码写错，而是Composer自动加载根本没扫到你的目录。
确认vendor/autoload.php是否被入口文件真正引入
ThinkPHP启动流程第一步必须加载Composer自动加载器，如果这一步失败，后续所有类加载都会跳过，框架甚至无法进入初始化阶段。
打开public/index.php，检查首行是否为【require __DIR__ . '/../vendor/autoload.php';】，注意路径不能是'./vendor/autoload.php'或'../../vendor/autoload.php'，必须严格匹配项目结构。
在命令行执行php -l vendor/autoload.php，验证该文件语法合法；若提示“No such file”，说明当前工作目录错误，需先cd到项目根目录再操作。
浏览器访问public/index.php时若返回500或空白页，立即查看Web服务器错误日志，搜索“failed to open stream”或“autoload.php”，这是最直接的引入失败证据。
强制重建autoload映射并验证扫描路径
composer dump-autoload不是万能药，但它能暴露配置是否生效。加-v参数是关键，它会逐行打印扫描动作，让你亲眼看到Composer到底有没有进你的目录。
① 在项目根目录执行：composer dump-autoload -v
② 观察终端输出中是否出现类似"Scanning /path/to/project/app/service for namespace appservice\"的行——如果没有，说明composer.json里的psr-4配置压根没被识别。
③ 若输出中只显示扫描了vendor/而完全跳过app/，立刻检查composer.json：autoload段是否拼写为"autoloader"、逗号是否遗漏、引号是否用了中文标点、缩进是否混乱。JSON格式错一个字符，整个autoload块就会静默失效。
这一步操作起来很简单，直接把命令敲进去就行，但别跳过-v参数，否则你永远不知道Composer究竟信了你哪一句配置。
清理autoload缓存文件再重生成
vendor/composer/目录下的autoload_*.php是持久化缓存，一旦生成失败或残留旧状态，即使改了composer.json并执行dump-autoload，PHP仍可能读取损坏映射。
执行：rm -f vendor/composer/autoload_*.php
再次运行composer dump-autoload -v，这次终端必须输出你自定义命名空间的扫描路径和匹配类名。
打开vendor/composer/autoload_psr4.php，用Ctrl+F搜索appservice，确认其值为["app/service/"]这样的数组——注意路径结尾不能带斜杠，也不能是"./app/service/"或"app/service"（少斜杠）。
检查PSR-4命名空间与目录结构是否严格对齐
PSR-4不是简单拼接路径，它会截掉命名空间前缀再拼剩余部分。配置"MyApp": "app/"，那么MyAppHttpControllersIndex就必须放在app/Http/Controllers/Index.php，而不是app/MyApp/Http/Controllers/Index.php。
方法一：验证类文件路径是否100%匹配命名空间
比如namespace appserviceUserService对应文件必须是app/service/UserService.php，【大小写必须完全一致】，Linux服务器上app/Service/会直接找不到。
方法二：用composer show -s确认当前生效的autoload配置
该命令会输出实际加载的psr-4映射列表，比翻composer.json更可靠，尤其当你改过多次又记不清哪次生效时。
方法三：临时启用classmap权威模式快速暴露漏扫文件
执行composer dump-autoload --classmap-authoritative -v，此时Composer将彻底禁用PSR-4 fallback，只查classmap表——如果类不在表里就立刻报错，不给你任何侥幸机会。
绕过TP Loader优先级冲突的实操方案
ThinkPHP默认用自己的Loader机制找类，它会先尝试按app/、library/等约定目录查找，找不到才fallback到Composer。若你把第三方SDK丢进extend/又没配autoload，TP根本不会把请求交给Composer处理。
如果你坚持要用extend/wechat/这类非标准路径：
第一步：在项目根目录composer.json的autoload.psr-4中添加"WeChat\": "extend/wechat/src/"（注意双反斜杠）
第二步：执行composer dump-autoload -o
第三步：删掉所有Loader::addNamespace()调用——TP6+已不推荐手动注册，混用会导致随机加载失败。
别在控制器里写require_once './extend/wechat/WxPayApi.php'，这破坏自动加载逻辑，IDE无法识别类型，且上线后容易因路径变更崩掉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
