$routes->group()是CodeIgniter 4组织后台路由的官方推荐方式，通过前缀、中间件、命名空间统一收束于闭包，避免手动拼接导致的维护失控；其三个参数为路径前缀、配置数组（含namespace/filter/hostname等）、闭包回调；嵌套分组时外层filter先执行；动态占位符必须写在闭包内路由方法中，不可置于group名称里。
$routes->group() 是 CodeIgniter 4 中组织后台路由最直接、最可控的方式，不是“可选技巧”，而是官方推荐的结构化手段。用错位置或忽略闭包作用域，会导致路由完全不生效。
为什么必须用 $routes->group() 而不是手写前缀
手动拼接路径（比如写 $routes->get('admin/dashboard', 'Admin::dashboard')）看似简单，但会快速失控：重复写 admin/、漏掉权限中间件、无法统一加命名空间、后续加子模块（如 admin/users/edit）时难以维护。$routes->group() 把前缀、中间件、命名空间全部收束到一个闭包里，逻辑上真正“属于同一域”。
$routes->group() 的三个关键参数怎么配
它接受三个参数：$routes->group($name, $options, $callback)，其中 $name 是路径前缀（如 'admin'），$options 是数组，$callback 是闭包。容易被跳过的坑在 $options：
-
'namespace' => 'App\Controllers\Admin'：必须显式指定，否则闭包内写的Hello::index仍按默认命名空间找，报Class not found -
'filter' => 'auth'：后台几乎都需登录校验，这里加 filter 比每个路由单独写->setFilter('auth')更安全、不易遗漏 -
'hostname' => 'admin.example.com'：如果后台走独立子域名，这个选项比在 Nginx 层做转发更干净，且能和前台路由彻底隔离
分组嵌套与中间件顺序的实际影响
CI4 允许嵌套分组，比如先 $routes->group('admin', [...])，再在里面套 $routes->group('api', [...])，最终生成 /admin/api/users。但注意：外层 filter 会先执行，内层 filter 后执行。如果你在外层加了 'filter' => 'auth'，又在内层加了 'filter' => 'cors'，请求进来时 auth 一定先于 cors 运行——这对 token 校验 + 跨域头设置的顺序很关键。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
常见错误是把 csrf filter 加在最外层 admin 分组，结果 API 接口因没传 token 被拦住。应该只在表单提交类路由（如 $routes->post('settings/save', ...)）上单独加 ->setFilter('csrf')。
带占位符的分组路由怎么写才不冲突
不要在分组名里用正则或通配符，$routes->group('admin/(:num)') 是非法的——$routes->group() 只接受纯字符串前缀。动态部分必须写在闭包内部的 add() 或 get() 里：
$routes->group('admin', ['namespace' => 'App\Controllers\Admin'], function($routes)
{
$routes->add('users/(:num)', 'User::view/$1'); // ✅ 正确：/admin/users/123 → User::view(123)
$routes->add('logs/(:any)', 'Log::show/$1'); // ✅ 正确：/admin/logs/2026-09 → Log::show('2026-09')
});
如果误把 (:num) 写进 group 名，CI4 会静默忽略该分组，所有子路由失效，且无任何报错提示——这是最常被忽略的调试盲点。
