ThinkPHP根路径404需配置默认控制器：一、路由文件绑定Route::get('/', 'Index/index')并清缓存；二、route.php设default_module、default_controller等全局参数；三、入口文件注入$_GET['s']；四、Apache .htaccess添加RewriteRule兜底；五、中间件判断空路径并重定向。
如果您在 ThinkPHP 项目中访问根路径（如/或/index.php）时出现 404 或跳转异常，很可能是框架未正确识别默认控制器。以下是配置默认控制器的具体操作步骤：
一、修改路由配置文件中的默认路由规则
ThinkPHP 6+ 默认不预设根路径对应的控制器，需在路由配置中显式声明入口映射。该方式适用于单应用模式，且无需修改核心配置即可生效。
1、打开
config/route.php文件。
2、确认已引入路由门面：添加
use think\facade\Route;（若不存在）。
立即学习“PHP免费学习笔记（深入）
”；
3、在文件末尾或路由注册区域添加默认路由绑定语句：
Route::get('/', 'Index/index');
4、保存文件后清除路由缓存：执行命令
php think route:clear。
二、设置 URL 路由的默认模块与控制器
通过全局路由参数可统一指定未显式声明路径时的默认响应目标，影响所有未匹配路由的兜底行为。
1、编辑
config/route.php文件。
2、在 return 数组中添加以下配置项：'default_module' => 'index', 'default_controller' => 'Index', 'default_action' => 'index'。
3、确保
'url_route_must' => false已启用，否则严格路由模式下该配置可能被忽略。
4、若使用多应用模式，需将
default_module值改为对应应用目录名（如admin）。
三、调整入口文件的默认调度逻辑
在不依赖路由配置的前提下，可通过修改入口脚本直接干预请求分发流程，适用于调试或特殊部署场景。
1、定位项目入口文件（通常为
public/index.php）。
PHP 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
2、查找
think\App::run()->send()执行前的代码段。
3、插入条件判断逻辑：
if (empty($_GET['s']) && !isset($_SERVER['PATH_INFO'])) { $_GET['s'] = '/index/index'; }。
4、确保该逻辑位于框架初始化之前，避免与自动 PATH_INFO 解析冲突。
四、重写 URL 规则并指定默认控制器（Apache 环境）
当 Web 服务器层未正确传递 PATH_INFO 时，框架无法解析控制器名称，此时需借助服务器重写规则补全默认值。
1、确认项目根目录存在
.htaccess文件。
2、在
RewriteRule
指令块中添加兜底规则：
RewriteRule ^$ index.php?s=/index/index [QSA,L]。
3、同时保留原有 ThinkPHP 重写规则（如^(\w+)/(\w+)/(\w+)$分支）以兼容其他路径。
4、重启 Apache 或验证重写模块已启用（a2enmod rewrite）。
五、通过中间件拦截并重定向至默认控制器
利用中间件在请求生命周期早期介入，可实现动态判定与控制器注入，适合需权限校验或环境判断的场景。
1、执行命令创建中间件：
php think make:middleware DefaultControllerMiddleware。
2、编辑生成的中间件文件，在
handle
方法内添加路径判空逻辑：
if ($request->path() === '') { return redirect('/index/index'); }。
3、在
app/middleware.php中注册该中间件为全局中间件。
4、确保中间件顺序置于路由解析之前（即在
\think\middleware\LoadLangPack::class之后、\think\middleware\RouteCheck::class之前）。