thinkphp多模块404主因是请求未进入框架，需先访问/index.php/route/test验证：若返回原生404且无x-powered-by头，说明入口接管失败；再检查web服务器模块根目录配置、路由前缀匹配、route:list输出及强制路由对静态资源的拦截。
ThinkPHP多模块访问404，八成不是路由写错了，而是请求压根没进框架——Web服务器直接返回原生404，PHP连初始化都没执行。先确认这点，再往下查。
第一步：验证请求是否真正进入ThinkPHP
打开浏览器，访问 http://你的域名/index.php/route/test（确保这个路由没定义）。
- 如果看到 ThinkPHP 调试页提示「找不到路由」，说明框架已接管，问题在路由层或模块配置；
- 如果返回 Nginx/Apache 原生 404 页面，且响应头里没有 X-Powered-By: ThinkPHP，那就停在这里——问题出在入口接管，别调路由代码了。
第二步：检查Web服务器是否正确转发到模块入口
多模块常见错误是 Web 根目录指向错位：
- Nginx 用户：每个模块（如
/admin、/api）应有独立的server块或location块，root 必须精确指向对应模块的public/目录，不能统一指向项目根目录； - Apache 用户：确认每个模块子目录（如
/admin/）下.htaccess存在且生效，对应<directory></directory>中设置了 AllowOverride All； - IIS 用户：需安装 URL Rewrite 模块，并在模块根目录放
web.config，规则要匹配模块路径前缀（如^admin/(.*)$）。
第三步：确认模块路由注册与路径匹配
即使请求进了 PHP，模块也可能被忽略：
- 检查
route/app.php或模块专属路由文件中，是否用Route::group(['prefix' => 'admin'])正确声明了模块前缀； - 访问地址必须带前缀，比如模块路由定义为
Route::get('user/list', ...)且在admin分组里，那必须访问 /admin/user/list，而不是/user/list； - 运行命令 php think route:list，确认输出里真有你写的模块路由；为空或缺失，说明路由文件没加载，检查是否放在
route/下、有没有被条件语句跳过、缓存是否清干净（删runtime/cache/）。
第四步：排查强制路由与静态资源干扰
开启 'url_route_must' => true 后，所有未显式定义的路径都会 404：
- /static/css/app.css、/uploads/logo.png 这类静态资源也会被拦截；
- 解决办法：在路由文件末尾加放行规则，例如
Route::rule('static/[:all]', 'static/$1', 'GET', ['ext' => 'css|js|png|jpg|gif']);； - 或者关闭强制模式（仅开发调试时），改用
Route::miss()统一处理未匹配请求。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
