开启 route::setdebug(true) 可查看路由匹配详情，需配合 app_debug=true；优先级冲突、resource 路由干扰或规则顺序错误是 404 主因；route::rule() 不支持 debug 参数，应通过全局调试或中间件定位。
ThinkPHP 路由匹配失败时怎么快速定位是哪条规则没生效
路由没走预期的控制器，debug 模式默认不记录路由匹配过程，光看日志根本不知道请求被哪条规则吞了、哪条规则压根没参与匹配。
必须手动开启路由调试日志：在 app/route.php 开头加一行 think\facade\Route::setDebug(true);，再配合 Log::debug() 手动打点；否则 Route::rule() 写错了、顺序颠倒、闭包返回 false，全靠猜。
- 只对当前请求生效，不影响其他路由，适合线上临时排查
- 开启后会在日志里输出每条规则的匹配尝试、参数提取结果、是否跳过等细节
- 注意别在生产环境长期开着，会拖慢所有请求，且日志量暴增
为什么 Route::get('api/user', 'api.User/index') 在调试模式下仍 404
不是调试开关的问题，而是 ThinkPHP 的路由优先级机制在作祟：系统内置的「变量规则」和「资源路由」可能提前截获请求，导致你写的规则根本没机会执行。
常见干扰项包括：Route::resource() 注册的 api/user、全局变量规则如 [:id] 匹配了 /api/user 中的 user 当作 ID、或者 Route::any() 通配兜底规则位置太靠前。
- 用
php think route:list查看当前全部注册路由，确认你的规则是否在列表中、顺序是否合理 - 把自定义路由写在
route.php最前面，避免被 resource 或 group 覆盖 - 测试时临时注释掉
Route::resource()和Route::group()，排除干扰
Route::rule() 的 ['debug' => true] 参数根本不起作用
这个参数根本不存在 —— Route::rule() 不接受 debug 配置项，文档里也没有。有人误把中间件配置或日志配置套用到路由上，白折腾。
真正控制单条路由调试行为的，只有两个方式：一是全局 Route::setDebug(true)，二是给该路由绑定一个中间件，在中间件里打印 $request->url() 和 Route::current() 看是否命中。
- 别在
Route::rule()第四个参数（$option）里硬塞'debug' => true，PHP 不报错但完全无效 - 如果只想观察某类接口（比如所有
/api/*），推荐用中间件 + 日志，比全局 debug 更精准 - 检查
config/app.php中的'app_debug' => true是否开启，这是整个调试体系的前提
调试模式下日志里看不到 SQL，但路由日志却一堆重复记录
这是因为 ThinkPHP 的日志通道默认把「路由匹配过程」和「SQL 执行」分到了不同通道，而路由 debug 日志默认走 trace 级别，SQL 则依赖数据库配置里的 'log_sql' => true 和 'sql_explain' => false 等开关。
更关键的是：路由 debug 日志在每次匹配都会触发，而一个请求可能经历多次路由解析（比如子域名、多应用、重定向后再次进路由），所以看起来“重复”。
- 想关掉冗余路由日志？删掉
Route::setDebug(true)，或只在需要时动态开启 - 要看到 SQL，确保
config/database.php里'log_sql' => true，且当前连接未被设置为'debug' => false - 别指望
Log::channel('sql')能打出路由日志，它们压根不在一个 channel 里
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
