ThinkPHP路由分组前缀必须用Route::group()第一个参数传字符串并配合闭包注册子路由，缺一不可；常见失效原因包括漏闭包、用废弃数组写法、子路径或前缀多加斜杠、控制器未带完整命名空间。
ThinkPHP路由分组前缀必须用 Route::group() 的第一个参数传入字符串，且必须配合闭包定义内部路由——缺一不可，否则前缀不生效、路由不注册、url() 生成链接也不带前缀。
为什么 Route::group('api') 写了却没效果
最常见原因是：漏掉闭包，或闭包里没用 Route::get() 等静态方法注册子路由。
-
Route::group('api', ['user' => 'User/index']);→ ❌ TP6+ 已废弃数组写法，完全不注册路由 -
Route::group('api', function () {});→ ❌ 闭包为空，没注册任何子路由，前缀白加 -
Route::group('api', function () { Route::get('user', 'User/index'); });→ ⚠️ 控制器类名没带命名空间，运行时报Class User does not exist -
Route::group('/api/', function () { Route::get('/user', ...); });→ ❌ 前缀和子路径都带斜杠，拼成//api//user，404
Route::group() 前缀怎么写才正确
前缀字符串不带开头斜杠，子路由路径也不加开头斜杠，控制器类名必须含完整命名空间。
- ✅ 正确示例：
Route::group('api/v1', function () { Route::get('user/:id', 'api.v1.User/read'); Route::post('user', 'api.v1.User/save'); }); - 前缀
'api/v1'是纯字符串，不是变量，别写成$prefix - 子路径
'user/:id'开头不能有/，否则匹配失败 - 控制器
'api.v1.User/read'中的api.v1.是命名空间，对应app\controller\api\v1\User类
url() 不输出前缀？检查这三点
加了前缀但 url('user/read') 还是输出 /user/1 而不是 /api/v1/user/1，问题不在前缀本身，而在 URL 生成机制。
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
立即学习“PHP免费学习笔记（深入）”；
- 路由没设
name()：必须显式命名，如Route::get('user/:id', 'api.v1.User/read')->name('api.user');，然后调用url('api.user', ['id' => 1]) - 用了资源路由但没指定命名空间：
Route::resource('user', 'User')在分组里，得加->namespace('api.v1')，否则控制器找错位置 - 域名路由混用：
Route::domain()和Route::group()不能嵌套，否则url()既不带域名也不带前缀；若需api.example.com/v1/user，得分开配route_domain+Route::domain('api', ...)+ 分组
前缀和中间件、Nginx rewrite 冲突吗
会。路由前缀只在静态注册阶段起作用，所有运行时修改路径的行为都会破坏框架内部的路由解析与 URL 反解一致性。
- ❌ 别在中间件里改
Request::server('PATH_INFO')，会导致Route::current()拿不到原始匹配结果 - ❌ Nginx rewrite 把
/api/user重写成/user再交给 TP 处理，TP 收到的仍是带前缀的 pathinfo，反而要额外兼容 - ✅ 真正可靠的只有两种方式：路由定义时用
Route::group()显式声明，或动态注册时用Route::rule()手动拼接路径
最容易被忽略的是：前缀只对闭包内用 Route::get() 等注册的路由生效，不透传给链式调用（比如 ->prefix('v1')），也不影响 config/route.php 里的配置项。一旦漏掉闭包或命名空间，整个分组就“隐形”了。
