ThinkPHP API路由前缀怎么统一设置-ThinkPHP-PHP中文网

route::group()必须用闭包包裹且前缀不能带斜杠，控制器需写完整命名空间，url生成须显式命名路由；版本化api需用字符串字面量分组，命名空间与目录结构须严格大小写对齐。

thinkphp api路由前缀怎么统一设置

必须用 Route::group() 静态包裹，其他方式全失效。中间件改 PATH_INFO、Nginx rewrite、Route::domain() 配合、甚至 url.pathinfo_depr 配置，都不能让前缀真正参与路由匹配和 URL 生成双向流程。

为什么 `Route::group('api', [...])` 写了却没生效

常见错误集中在三处：

Route::group('api', function () { ... }); 漏掉闭包 —— 没闭包，内部路由根本不会注册
前缀或子路径写了开头斜杠，比如 Route::group('/api/', function () { Route::get('/user', ...); }); → 实际匹配 //api//user，404
控制器类名没带完整命名空间，如写成 'User/read' 而非 'api/User/read'，框架找不到类

`url()` 生成链接不带前缀？检查这三点

前缀加了但 url('user/read') 还是输出 /user/1，不是 /api/user/1，问题不在分组本身，而在 URL 反解机制：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

没给路由显式命名：Route::get('user/:id', 'api/User/read')->name('api.user');，然后必须用 url('api.user', ['id' => 1])
用了数组式写法（已废弃）：Route::group('api', ['user' => 'User/index']) → TP6+ 不识别，路由不注册
混用了 Route::domain()：一旦在 group 外套 domain，url() 就丢前缀和域名，这是底层冲突，不能共存

版本化 API 怎么配才稳

别用变量路由（如 Route::rule(':version/user', ...)），线上缓存和大小写敏感会突然崩。正确姿势是每个版本独立 group：

Route::group('v1', function () {
    Route::get('user/:id', 'api/v1.User/read');
    Route::post('user', 'api/v1.User/create');
})->middleware('throttle:60,1');

Route::group('v2', function () {
    Route::get('user/:id', 'api/v2.User/read');
    Route::post('user', 'api/v2.User/create');
})->middleware('throttle:100,1');

注意：v1 和 v2 必须是字符串字面量，不能写成 config('api.version') 或变量 —— 否则路由缓存编译失败，开发环境正常，上线直接全站 404。

最易被忽略的是命名空间与目录结构的严格对齐：api/v1.User 对应 app/controller/api/v1/User.php，且文件首行必须是 namespace app\controller\api\v1;。Linux 下大小写错一个字母，就是 500 或 404。