ThinkPHP 5.1 路由分组必须显式 return 数组或链式结果，否则失效；TP6.x 则要求闭包必须接收 $route 参数并调用其方法，且路由注册时机、对象模型和配置方式全面重构。
ThinkPHP 5.1 的路由分组写法和常见报错
TP5.1 使用 Route::group() 配合闭包定义分组，最易踩的坑是「未 return 路由定义」导致整个分组失效。比如写成：
Route::group('api', function () {
Route::rule('user', 'api/User/index');
}); // ❌ 缺少 return，TP5.1 不会注册这条路由
正确写法必须显式 return 一个路由规则数组或链式调用结果：
Route::group('api', function () {
return [
'user' => 'api/User/index',
'post/:id' => 'api/Post/read'
];
}); // ✅
- 路径前缀（如
'api'）不自动加斜杠，Route::group('api/v1', ...)就是匹配/api/v1/xxx - 分组内不能混用
Route::rule()和数组返回，TP5.1 的闭包分组只认 return 的数组或Route::get()等链式调用的最终结果 - 如果在
route.php里用了use think\Route;，记得闭包参数里别漏掉$route—— 实际上 TP5.1 分组闭包默认不传参，这点和 6.x 完全不同
ThinkPHP 6.x 的路由分组必须带命名空间和中间件参数
TP6.x 的 Route::group() 签名变了：第一个参数是前缀，第二个必须是闭包，且闭包参数固定为 $route（类型是 think\route\RuleGroup）。不传或传错会导致 Call to a member function rule() on null。
典型错误写法：
立即学习“PHP免费学习笔记（深入）”；
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
Route::group('admin', function () { // ❌ 没传 $route，$route->rule() 会报错
$route->rule('login', 'admin/Login/index');
});
正确写法：
Route::group('admin', function ($route) { // ✅ 显式接收 $route
$route->get('login', 'admin/Login/index');
$route->post('logout', 'admin/Login/logout');
});
- TP6.x 分组默认不继承全局中间件，需手动调用
$route->middleware()，否则auth、cors类中间件不会生效 - 控制器类名解析规则变严格：
'admin/Login/index'对应app\controller\admin\Login::index()，目录结构必须和命名空间一致，大小写敏感 - TP6.3+ 支持
Route::domain()嵌套分组，但Route::group()内不能再调用Route::domain()，否则路由注册顺序错乱
从 TP5.1 迁移到 TP6.x 时 route.php 的关键改写点
直接复制 TP5.1 的 route.php 到 TP6.x 项目里，90% 会 404 或报闭包参数错误。核心差异不是语法糖，而是路由对象模型重构了。
- TP5.1 的
Route::any()在 TP6.x 必须拆成$route->any()，且不能写在分组外；分组外只能用Route::get()等静态方法 - TP5.1 支持
Route::pattern(['id'=>'\d+'])全局正则，在 TP6.x 必须改到config/route.php的'patterns'配置项里，否则无效 - TP5.1 的
bind绑定模块（如Route::bind('api', 'api')）在 TP6.x 已移除，改用Route::domain()或子域名路由 + 分组组合实现 - TP6.x 的
Route::import()不再支持 PHP 数组文件导入，只接受 YAML/JSON，若沿用旧版数组配置，需重写为return ['rule' => [...]];格式并用Route::import('path/to/php')手动加载
调试路由不生效时优先检查的三处位置
别急着重写，先看这三处——80% 的「明明写了路由却 404」问题出在这儿。
-
config/app.php中的'app_debug'是否为true？TP6.x 关闭调试模式后，路由缓存强制开启，改了route.php必须运行php think route:clear - TP6.x 的路由文件默认是
app/route.php，但如果你在config/app.php里改了'route_config_file'，实际加载的就不是这个文件 - TP5.1 允许在控制器里用
Route::rule()动态注册，TP6.x 禁止运行时注册（除命令行场景），所有路由必须在应用启动初期完成注册，否则直接忽略
跨版本适配最难的不是语法，是路由注册时机和对象生命周期的理解偏差。TP6.x 把 RuleGroup 当作一级公民，而 TP5.1 的分组只是字符串前缀+规则数组的语法糖。改的时候，别只换函数名，得重想路由组织逻辑。
