CI4.7.2搭建后台管理系统必须显式注册路由、避免在Services.php中执行IO操作、控制器方法签名须与路由参数严格匹配；否则将导致/admin 404、session启动失败或动态参数传参错误等不可预测问题。
CI4.7.2 搭建后台管理系统，核心不是“从零写一堆代码”，而是快速锁定三个关键动作：路由必须显式注册、服务容器别在 Services.php 里做连接/IO、控制器方法签名要和路由参数严格匹配。跳过这三点，后面全在填坑。
为什么 /admin 总是 404？路由没显式绑定
访问 http://localhost/admin 报错 Can't find a route for 'get: admin'，不是框架坏了，是你没告诉 CI4 这条路径该去哪——CI4.7.2 默认关闭自动路由，/admin 不会自动映射到 Admin 控制器。
- 打开
app/Config/Routes.php，在$routes->set404Override()前添加：$routes->get('/admin', 'Admin::index'); -
/admin必须带前导斜杠；Admin类名首字母大写，index方法名小写；app/Controllers/Admin.php文件必须存在且类定义为class Admin extends BaseController - 改完立刻执行
php spark cache:clear——CI4.7.2 的路由缓存不自动失效，不清理就永远读旧配置
登录后进不去后台首页？service('session') 启动时就崩了
常见现象：表单提交成功，但重定向到 /admin 后白屏或报 Call to a member function get() on null。大概率是 app/Config/Services.php 里的 session() 方法做了不该做的事。
-
session()方法体里不能出现session()->start()、session()->get()或任何实际读写操作——这些必须留到控制器里真正需要时才调用 - 检查是否写了类似
if (ENVIRONMENT === 'production') { $config = json_decode(file_get_contents('/path/config.json')); }这种同步 I/O，开发环境也会执行，一卡就是 1–2 秒 - 确认没误用
$container->set('session', new \CodeIgniter\Session\Session())——这会让 session 实例在启动时立即构造；应改为$container->singleton('session', function() { return new \CodeIgniter\Session\Session(); })
动态路由传参失败？控制器方法签名和占位符不一致
比如配置了 $routes->get('/admin/user/edit/(:num)', 'Admin::editUser/$1');，但访问 /admin/user/edit/123 时抛出 ArgumentCountError。
- 控制器方法必须显式声明类型提示：
public function editUser(int $id)，不能写成public function editUser($id)或public function editUser(string $id) -
/:num只匹配纯数字，若 URL 是/admin/user/edit/abc，这条路由根本不会命中，也不会 fallback 到其他规则 - 如果想支持字母数字混合 ID（如 UUID），改用正则：
$routes->get('/admin/user/edit/([a-f0-9\-]{36})', 'Admin::editUser/$1');，对应方法签名改为public function editUser(string $id)
为什么第一次访问后台特别慢？Services.php 里藏了远程调用
冷启动耗时超过 800ms，基本可以断定 Services.php 中某个服务方法在启动时做了真实连接或文件读取。
- 在
public/index.php开头加计时：$startTime = microtime(true);，在require FCPATH . 'vendor/autoload.php';后加echo '[Services load: ' . round(microtime(true) - $startTime, 3) . "s]\n"; - 逐个注释
Services.php中的database()、cache()、email()方法，观察耗时变化；重点排查含new \Redis()、curl_init()、file_get_contents()的代码块 - 数据库连接不要在
database()方法里调用\Config\Database::connect()；缓存驱动初始化别调cache()->get()——这些都该延迟到第一次service('database')被调用时再触发
CI4.7.2 的后台搭建，难点不在功能实现，而在克制——克制住把初始化逻辑塞进 Services.php 的冲动，克制住省略类型提示的惯性，克制住不清理路由缓存的懒惰。这三个点踩中任意一个，后续所有页面都会变得不可预测。
