首先确认是否开启路由功能，检查config/app.php中'url_route_on'是否为true；接着验证路由定义位置及语法正确性，确保route/route.php中规则无误；然后检查URL访问模式，确保入口文件index.php正确指向public目录；若隐藏index.php需配置服务器重写规则，Apache启用mod_rewrite或Nginx添加rewrite规则；最后开启调试模式查看日志或使用php think route:list命令排查路由匹配情况。
ThinkPHP 路由无效或出现 404 错误，通常和路由配置、URL 模式、入口文件路径或服务器重写规则有关。以下是常见排查步骤，帮助你快速定位问题。
检查是否开启路由功能
ThinkPHP 默认开启路由，但如果你在配置文件中关闭了，路由将不会生效。
确认 config/app.php 中的 'url_route_on' 是否设置为 true：- 'url_route_on' => true // 必须开启
- 'route_annotation' => true // 如果使用注解路由，建议开启
确认路由定义位置和语法
路由规则应写在 route/route.php 文件中，格式错误会导致不生效。
- 检查是否使用了正确的闭包或控制器绑定方式，例如：
use think\facade\Route;
Route::get('hello', 'index/hello'); - 如果是模块/控制器/方法模式，确保控制器存在且方法可访问（public）
- 注意大小写：Windows 不敏感，Linux 敏感，控制器名称建议首字母大写
检查 URL 访问模式和入口文件
ThinkPHP 推荐使用统一入口 index.php，URL 应正确指向 public 目录。
立即学习“PHP免费学习笔记（深入）”；
- 正确访问地址类似：http://yourdomain.com/index.php/hello
- 如果去掉了 index.php，需配置服务器伪静态（如 Nginx 或 Apache .htaccess）
- Apache 需启用 mod_rewrite，并确保 public/.htaccess 生效
- Nginx 配置示例：
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
} }
开启调试模式查看路由匹配情况
开启调试后，可通过日志或异常信息判断是否进入路由。
- config/app.php 中设置 'app_debug' => true
- 访问时观察是否抛出路由未匹配提示
- 查看 runtime/log 目录下的日志，搜索 route 相关信息
- 可使用命令行查看路由列表（如果有安装 think命令行工具）：
php think route:list
基本上就这些。多数 404 是因为服务器没重写、入口路径不对或路由未开启。逐项检查，一般都能解决。
