ThinkPHP 6+ 的 app_namespace 配置不控制自动加载，类找不到的根本原因是 Composer 的 PSR-4 映射未正确配置或未执行 composer dump-autoload -o；必须确保 composer.json 中 "app\\": "app/" 映射准确、路径与命名空间严格一致，且刷新后生效。
ThinkPHP 6+ 的 app 命名空间不是靠配置项“打开”就能生效的，它默认由 Composer 的 PSR-4 映射驱动；如果类找不到，问题几乎一定出在路径、命名空间声明或 autoload 未刷新这三处。
为什么改了 config/app.php 里的 app_namespace 还是不生效
app_namespace 配置只影响框架内部对「默认应用目录」的解析逻辑（比如路由匹配时拼接控制器类名），它不参与自动加载机制。也就是说：
- 你把
app_namespace改成"app_v2"，但没在composer.json里配"app_v2\": "app_v2/"，那app_v2controllerIndex依然不会被加载 - 该配置对
extend/、runtime/、自定义路径完全无效 - 模块化项目中，若 URL 含模块名（如
/admin/index），实际加载的是appdmincontrollerIndex，此时app_namespace被忽略，模块名直接拼进命名空间
app 目录下的类为什么报 Class not found
根本原因是 PSR-4 映射断裂。ThinkPHP 6+ 不再使用 thinkLoader::addNamespace() 或手动 require，一切以 composer.json 的 autoload 段为准。
- 检查类文件是否在
app/controller/Index.php（注意首字母大写、.php 后缀） - 确认文件顶部有
namespace appcontroller;（app小写，末尾带反斜杠） - 确认
composer.json中已声明："autoload": { "psr-4": { "app\": "app/" } } - 改完必须运行
composer dump-autoload -o，否则开发环境大概率不生效 - Windows 下容易漏掉双反斜杠——写成
"app": "app/"是错的，必须是"app\": "app/"
如何让 app/common/ 下的类能 new appcommonServiceUser
不能靠改配置或加 Loader 方法，必须走 Composer 注册流程：
立即学习“PHP免费学习笔记（深入）”；
- 在
app/common/Service/User.php文件顶部写namespace appcommonService; - 确保文件路径与命名空间严格对齐：
app/common/Service/User.php→appcommonServiceUser - 修改项目根目录
composer.json的autoload.psr-4，添加"app\common\": "app/common/" - 执行
composer dump-autoload -o（加-o是关键，否则 classmap 不生成，开发时可能失效） - 别把
User.php放在app/common/service/（小写 service）——PSR-4 路径大小写敏感，Linux 环境下直接 404
Loader::addPsr4() 和 composer autoload 冲突怎么办
手动调用 Loader::addPsr4() 在 TP6 中属于无效操作：框架启动流程已跳过该注册逻辑，且和 Composer 加载器并存会导致类偶尔加载成功、偶尔失败。
- 该方法不会报错，但也不会起作用——类文件压根不会被引入
- 如果你看到
Class 'xxx' not found却确认路径和命名空间都对，第一反应应是检查是否误用了Loader::addPsr4() - 所有自定义路径映射，必须统一收口到
composer.json的autoload.psr-4中，然后dump-autoload -o - 扩展包未声明 autoload 时，不要试图用
Loader::addPsr4()补救，而是手动补全composer.json并重新 dump
最容易被忽略的一点：Composer 的 PSR-4 映射是静态生成的，dump-autoload -o 不只是“刷新”，它是生成 vendor/composer/autoload_psr4.php 的唯一方式；跳过这步，等于没配。
