ThinkPHP路由未生效且必须加index.php访问，是因伪静态未启用或配置错误；需检查Apache的.htaccess与AllowOverride设置，或Nginx的try_files规则；同时确认路由定义位置、大小写一致性、缓存清理及多应用路径。
ThinkPHP 路由没生效，index.php 必须加才能访问？
这是典型伪静态未启用或配置错位导致的。ThinkPHP 默认依赖 Web 服务器重写规则把请求统一转发到 index.php，如果直接访问 /user/list 报 404，大概率是 Apache 或 Nginx 没配好重写规则。
常见错误现象：http://localhost/user/list 404，但 http://localhost/index.php/user/list 正常；或者本地开发环境能跑，部署到线上就全挂。
- Apache 用户检查
.htaccess是否存在且被允许解析（AllowOverride All必须开启） - Nginx 用户确认 server 块里有这段：
location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>} - 宝塔、AMH 等面板用户别只点“伪静态”下拉选 ThinkPHP，还要手动检查生成的规则是否真写进了配置文件并重载了 Nginx
Route::get() 定义了路由，但访问仍 404
ThinkPHP 的路由注册顺序和作用域很关键，不是写了就一定生效。最常踩的坑是：在闭包或中间件里动态注册、或放在了条件分支中，结果根本没执行到。
使用场景：想给后台接口单独加前缀，或对某组路由统一加中间件。
立即学习“PHP免费学习笔记（深入）”；
- 确保路由定义写在
route/route.php中，或通过Route::import()显式加载的文件里 - 不要在控制器方法、模型构造函数、或
app_init钩子中调用Route::get()—— 此时路由系统还没初始化完 - 注意命名空间：如果用了
Route::domain()或Route::group()，要确认当前请求域名或路径前缀匹配，否则路由压根不进匹配队列
URL 大小写敏感导致 404（尤其 Linux 服务器）
Windows 开发时一切正常，一上 Linux 就 404，八成是 URL 路径大小写不一致。ThinkPHP 默认区分大小写，而 Windows 文件系统不区分，所以本地能绕过，生产环境直接崩。
性能影响很小，但兼容性极关键——尤其前端拼 URL 写了 /User/List，后端路由却定义的是 /user/list。
- 检查所有前端发起的请求 URL，与
Route::get('/user/list', ...)中的路径完全一致（包括斜杠开头、大小写） - 如需兼容，可在
config/route.php加配置：'url_convert' => true,
启用自动转小写（但会掩盖命名不规范问题，慎用） - 更稳妥的做法：在 Nginx/Apache 层做 301 重定向，或前端统一用小写路径
调试时 php think route:list 不显示自定义路由
这个命令是排查路由是否被正确加载的黄金手段。如果它不显示你写的路由，说明框架根本没读到，不是匹配失败，而是压根没注册。
容易被忽略的地方：ThinkPHP 6+ 默认只扫描 route/route.php 和 route/ 目录下的 PHP 文件，不会递归子目录，也不会自动加载非标准命名的文件。
- 运行命令前先清空缓存：
php think clear:route，否则可能看到旧缓存 - 确认路由文件返回的是数组（ThinkPHP 6.0+ 要求），不是直接执行
Route::get() - 如果用了多应用模式，检查是否在对应应用的
route/目录下定义，而不是全局route/
复杂点在于：路由加载时机、配置加载顺序、以及命令行环境和 HTTP 环境的差异。有时候 php think route:list 能看到，但浏览器访问还是 404 —— 那就得回头查重写规则和请求路径是否真的进了框架入口。
