ThinkPHP多模块报404或“Module not exists”主因是入口文件未显式绑定模块且未开启多模块支持；需在index.php中调用App::bind()、配置app_multi_module为true、确保模块目录名与命名空间一致、路由文件置于对应模块route.php中，并正确配置子域名绑定。
ThinkPHP 多模块访问报错：入口文件没改对
多模块项目启动就 404 或 “Module not exists”，大概率是 index.php 里没显式指定模块名，框架默认只找 app 目录下的 index 模块。
ThinkPHP 6 默认关闭多模块支持，入口文件必须手动加载模块配置。不改 index.php，光在 route/ 里配路由没用。
- 确认你的模块目录如
app/admin、app/api已存在且结构合规（含controller/、config/等） - 打开
public/index.php，找到thinkApp::run()调用前，加一行：App::bind('admin')（若要默认访问 admin 模块） - 更通用的做法是动态绑定：用
$_GET['s']或请求路径解析模块名，再调用App::bind($module)，否则子域名或路径模式路由无法触发对应模块 - 注意：绑定后控制器命名空间必须匹配，比如
appdmincontrollerIndex，不能漏掉admin这一级
路由规则写在哪个 route 文件里才生效
多模块下，route/app.php 是全局路由，不区分模块；各模块自己的路由必须放在 app/模块名/route.php（TP6.1+）或 app/模块名/config/route.php（旧版），否则路由注册时根本不会加载。
常见错误是把所有路由都堆进 route/app.php，结果访问 /admin/login 时，框架找不到 admin 模块下的 Login 控制器——因为该路由没在 app/admin/route.php 里注册。
立即学习“PHP免费学习笔记（深入）”；
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 模块级路由文件必须返回数组，格式如：
return ['admin/login' => 'admin.controller.Login/login'] - 如果用了闭包定义路由，确保闭包内调用的是当前模块的控制器类，别误写成
appcontroller... - 命令行执行
php think route:list可验证路由是否被加载，没出现在列表里的，基本就是放错位置或文件名不对（必须是route.php，不是route.php.bak）
“Module not exists” 错误但模块目录明明存在
报这个错，不代表模块目录不存在，而是框架没把它识别为合法模块——最常踩的坑是模块配置缺失或命名空间不一致。
ThinkPHP 按模块名自动推导命名空间和路径，一旦不一致，就会跳过加载。
- 检查
app/模块名/config/app.php是否存在，且包含'namespace' => 'app\模块名'（注意双反斜杠） - 模块目录名必须全小写，且与命名空间第二段严格一致，比如目录叫
app/Admin，但命名空间写appdmin，就会失败 - 确认
config/app.php中的'app_multi_module'设为true（TP6 默认为false） - 开启调试模式后，看日志里是否有
Module [xxx] not exists in提示，它后面会跟实际扫描的路径，对比你的真实路径，差在哪一截就很清楚了
子域名部署时模块路由不生效
用 admin.domain.com 访问 admin 模块，结果还是进了 index 模块，问题通常出在域名绑定逻辑没走通，或者路由分组没配对。
子域名不是自动映射模块的，必须显式绑定 + 分组路由配合。
- 在
app/extra/domain.php（或config/domain.php）中添加：'admin.domain.com' => 'admin' - 在
app/admin/route.php中，用Route::domain('admin.domain.com', function () { ... })包裹该模块全部路由 - 别在
route/app.php里用Route::domain绑定其他模块，会导致优先级混乱，主域名路由可能被覆盖 - 本地测试记得改
hosts文件，并确认 Web 服务器（Nginx/Apache）已将泛域名或具体子域名指向项目根目录
