根本原因是未启用多应用模式且子应用命名空间未注册：需在config/app.php中设置'app_multi'=>true，确保app/admin/config/app.php存在并定义'namespace'=>'app\admin'，否则框架无法识别该目录为独立应用。
ThinkPHP 8 的多应用模式下，app\ 下的子目录（如 app/admin）默认对应命名空间 app\admin，但这个映射不是自动生效的——你得手动告诉框架“这个目录要被当做一个独立应用来加载”，否则控制器、模型、命令等都不会被识别。
为什么 app/admin 目录下的控制器访问 404？
常见错误现象：创建了 app/admin/controller/Index.php，写了 app\admin\controller\Index 类，也加了路由，但访问 /admin/index 仍是 404。
根本原因：TP8 不会自动把 app/admin 当成一个应用；它只认 app\ 下的主应用，除非你显式启用多应用并注册命名空间。
- 确认
config/app.php中'app_multi' => true已开启（默认为false） - 检查
app/admin目录下是否有config/app.php文件（必须存在，哪怕为空） - 确保
app/admin/config/app.php中定义了'namespace' => 'app\admin'，否则框架无法将 URL 路由到该命名空间下的控制器 - 若用注解路由，还需在
config/annotation.php中扩展扫描路径：'paths' => ['app', 'app/admin']
app\ 子目录命名空间如何与 URL 路径对齐？
TP8 多应用的 URL 路径前缀默认和子目录名一致，但命名空间映射需人工对齐。比如 app/shop 对应 app\shop 命名空间，但控制器类名不能写成 Shop\Controller\Index —— 必须是 app\shop\controller\Index。
立即学习“PHP免费学习笔记（深入）”；
- 目录结构必须严格遵循 PSR-4：
app/shop/controller/Index.php→app\shop\controller\Index - 路由定义时，命名空间必须写全：
Route::get('shop/index', 'app\shop\controller\Index@index') - 若想让
/shop下所有请求都走 shop 应用，需在route/app.php中使用Route::domain()或Route::group()配合app\shop命名空间前缀 - 不建议手动改
composer.json的 autoload → psr-4 映射，TP8 多应用依赖内置的AppNamespace机制，而非 Composer 自动加载规则
自定义命名空间后，模型和命令怎么找得到？
一旦你启用了 app/admin 并设了 namespace，框架会按该命名空间去加载控制器、中间件、验证器……但模型和命令不会自动跟随——它们仍默认在 app\model 和 app\command 下扫描。
- 模型仍必须放在
app/model，命名空间保持app\model，不能写成app\admin\model（除非你额外配置模型命名空间映射） - 命令类必须仍在
app/command目录，命名空间为app\command或其子空间（如app\command\admin），框架不支持按应用分命令目录 - 若要在 admin 应用中调用特定逻辑，推荐封装成服务提供者（
app\provider\AdminService），在app/admin/config/app.php的providers数组中注册 - 不要试图把
app/command拆成app/admin/command——框架硬编码只扫app/command
最易被忽略的一点：多应用不是“开个开关就自动分治”，每个子应用的 config/app.php 是独立加载的，但像数据库、缓存等全局配置仍以主应用为准；如果 admin 应用需要不同数据库连接，得在 app/admin/config/database.php 里重写，而不是指望它自动继承或隔离。
