ThinkPHP6.1伪静态真正兼容路由分组的关键在于服务器重写规则、框架路由解析、分组定义逻辑三者严丝合缝；需确保Nginx/Apache透传原始路径、分组显式绑定命名空间与路由名、修复旧URL入口逻辑，并通过三步验证确认生效。

ThinkPHP6.1伪静态要真正兼容路由分组，关键不是“让URL变干净”，而是确保服务器重写规则、框架路由解析、分组定义逻辑三者严丝合缝。常见问题如 /admin/user/list 404、/api/v2/users 匹配到错误控制器、语言前缀（如 /zh/about）被忽略，根源几乎都出在这三层没对齐。

---

一、服务器层：Nginx/Apache 必须把请求正确送进分组上下文

TP6.1 默认依赖 PATH_INFO 或 REQUEST_URI 解析路径，而路由分组（如 Route::group('admin', ...)）的前缀是在 PHP 层拼接的，服务器不能把它当普通路径截断。

• Nginx 正确写法（放在 location / 块内，且必须在 location ~ \.php$ 之前）：

  location / {
      if (!-e $request_filename) {
          rewrite ^(.*)$ /public/index.php?s=$1 last;
      }
  }

  • ✅ /public/index.php 是硬性路径，不能省略
  • ✅ s=$1 把原始路径（如 /admin/user/list）作为 s 参数传入，TP6.1 路由器能据此还原出完整 pathinfo
  • ❌ 不要用 rewrite ^/admin/(.*)$ /public/index.php?s=admin/$1 —— 这会把分组逻辑提前下放到服务器，反而绕过 TP 的分组中间件和命名空间控制

• Apache .htaccess（必须放在 public/ 目录下）：

  立即学习“PHP免费学习笔记（深入）”；

  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?s=$1 [QSA,L]

  • ✅ s=$1 同样保证路径原始结构透传
  • ✅ QSA 保留原有 query 参数（如 ?page=2）
  • ❌ 避免用 index.php/$1（PATH_INFO 模式），TP6.1 在多分组场景下易因 fastcgi_split_path_info 配置不一致导致前缀丢失

---

二、框架层：分组定义必须显式承载前缀与语义边界

光写 Route::group('admin', [...]) 不够，TP6.1 不会自动把 admin 当作模块或命名空间，它只负责拼 URL 前缀和统一中间件。

Skill Weave Chains — 技能链路由引擎

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

下载

• 必须手动绑定命名空间与控制器路径：

  Route::group('admin', function () {
      Route::get('user/list', 'admin.UserController@list')->name('admin.user.list');
      Route::post('user/add', 'admin.UserController@add')->name('admin.user.add');
  })->middleware('check.admin')->option(['url_html_suffix' => '']);

  • ✅ admin.UserController 中的 admin. 是命名空间前缀，不是目录路径（需确认 app/controller/admin/UserController.php 存在）
  • ✅ ->name() 不可省略：权限校验、URL 生成（如 url('admin.user.list')）全靠它
  • ✅ ->option(['url_html_suffix' => '']) 防止分组内所有路由被自动加 .html（全局配置可能开启）

• 多级分组（如 API 版本隔离）要避免前缀叠加错乱：

  Route::group('api', function () {
      Route::group('v2', function () {
          Route::get('users', 'api.v2.UserController@list')->name('api.v2.users');
      })->option(['domain' => 'api.example.com']); // 可选：限定域名
  });

  • 最终访问地址是 /api/v2/users，不是 /v2/users 或 /api/users/v2
  • 外层 api 分组的中间件（如 CORS）会先执行，内层 v2 的 option 才覆盖

---

三、兼容旧 URL（如 /index.php/admin/user/list）需额外修复入口逻辑

部分老项目迁移时保留 index.php/xxx 形式，TP6.1 默认不识别。需在 public/index.php 开头补修复：

// public/index.php 第一行开始插入
if (!empty($_SERVER['PATH_INFO']) && strpos($_SERVER['PATH_INFO'], '/index.php/') === 0) {
    $_SERVER['PATH_INFO'] = substr($_SERVER['PATH_INFO'], 10);
}

同时确保 config/app.php 中：

'url_common_param' => true,   // 允许 s= 参数模式
'url_route_must'     => false, // 避免未匹配路由直接报错

再配合路由兜底：

// route/app.php 末尾
Route::any('[:module]/[:controller]/[:action]/[:id]', function () {
    $m = request()->param('module', 'index');
    $c = request()->param('controller', 'index');
    $a = request()->param('action', 'index');
    return redirect("/{$m}/{$c}/{$a}");
});

---

四、验证是否真兼容：三个必查点

• 请求 /admin/user/list 时，$request->rule()->getName() 应返回 'admin.user.list'，不是空或 app\controller\admin\UserController@list
• 中间件 check.admin 必须已注册且在分组内生效（可在中间件 handle() 中 dump($request->url()) 看原始路径）
• 执行 php think route:list，输出中该路由的 Name、Method、Rule、Route 四列应完整显示分组前缀与命名

不复杂但容易忽略。