必须采用模块化路由加载机制，即为admin、api、blog等模块分别创建独立Routes.php文件，按序加载并显式获取$routes实例，同时强制设置uriProtocol为REQUEST_URI，才能实现路由隔离与正确匹配。
要在 CodeIgniter 中实现多个功能模块（如 admin、api、blog）的路由独立管理且互不干扰，必须打破默认 routes.php 单文件集中配置的惯性，改用模块化路由加载机制——否则所有路由挤在同一个 $routes 对象里，顺序错乱、前缀覆盖、维护困难的问题会立刻爆发。
第一步：为每个模块创建独立路由文件
在 app/Config/Routes 目录下新建子目录 admin、api、blog，每个目录内放一个 Routes.php 文件。例如：app/Config/Routes/admin/Routes.php。
这一步不能跳过——CodeIgniter 4 的 $routes 实例是单例，但不同模块的路由注册必须隔离作用域，否则 $routes->get('/users') 在 admin 和 api 里同时定义就会冲突。
第二步：在主 routes.php 中按需加载模块路由
打开 app/Config/Routes.php，清空原有内容，在末尾插入：
if (is_dir(APPPATH . 'Config/Routes/admin')) {<br> require APPPATH . 'Config/Routes/admin/Routes.php';<br>}
if (is_dir(APPPATH . 'Config/Routes/api')) {<br> require APPPATH . 'Config/Routes/api/Routes.php';<br>}
if (is_dir(APPPATH . 'Config/Routes/blog')) {<br> require APPPATH . 'Config/Routes/blog/Routes.php';<br>}
注意：加载顺序决定匹配优先级。把最具体的模块（如 admin）放在最前面，通用模块（如 blog）放后面，避免 /admin/login 被 /(:any) 提前捕获。
第三步：各模块 Routes.php 内使用独立 $routes 实例
每个模块的 Routes.php 文件开头必须声明：$routes = service('routes');。
否则你会遇到致命错误：PHP Warning: Undefined variable $routes —— 因为 CodeIgniter 4 的路由服务不是全局变量，每次 require 都要显式获取新实例。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
然后写模块专属规则，例如 app/Config/Routes/admin/Routes.php：
$routes->add('/admin/login', 'Admin\Login::index');<br>$routes->add('/admin/dashboard', 'Admin\Dashboard::index');<br>$routes->add('/admin/users/(:num)', 'Admin\Users::view/$1');
而 app/Config/Routes/api/Routes.php 可以这样写：
$routes->add('/api/v1/posts', 'Api\v1\Posts::index');<br>$routes->add('/api/v1/posts/(:num)', 'Api\v1\Posts::show/$1');
【关键前提】 所有模块控制器类名必须带命名空间，且文件路径与命名空间严格对应。比如 Admin\Login 必须位于 app/Controllers/Admin/Login.php，否则 404。
第四步：强制启用 URI 协议为 REQUEST_URI
打开 app/Config/App.php，找到 public $uriProtocol 行，改为：public $uriProtocol = 'REQUEST_URI';
这是多模块路由生效的硬性条件。若保持默认的 AUTO 或 PATH_INFO，Apache/Nginx 在解析含多个斜杠的路径（如 /admin/login）时会截断或误判，导致模块前缀丢失，所有路由全部失效。
第五步：验证模块前缀是否被正确识别
启动开发服务器：php spark serve，访问 http://localhost:8080/admin/login。
如果返回 404，检查三件事：
① app/Controllers/Admin/Login.php 是否存在且类名为 Login（非 AdminLogin）；
② app/Config/Routes/admin/Routes.php 是否被实际加载（可在该文件首行加 die('admin routes loaded'); 测试）；
③ $routes = service('routes'); 是否写在每份模块路由文件最顶部。
这一步操作起来很简单，直接把文件拖进去就行。
