本文详解新手在 XAMPP 环境下部署 CI4 后无法通过 URL（如 /home）访问控制器的常见原因，重点说明路由注册的必要性、Routes.php 的正确配置方式，并提供可立即生效的实践方案。
本文详解新手在 xampp 环境下部署 ci4 后无法通过 url（如 `/home`）访问控制器的常见原因，重点说明路由注册的必要性、`routes.php` 的正确配置方式，并提供可立即生效的实践方案。
CodeIgniter 4 默认不启用自动控制器发现机制（即不会像 CI3 那样根据 URL 自动映射到同名控制器），所有 HTTP 请求都必须显式声明路由规则——这是你访问 http://localhost/home 报出 404 - Can't find a route for 'get: home' 的根本原因。即使 app/Controllers/Home.php 文件存在且语法无误，若未在路由配置中注册该路径，CI4 就会直接返回 404。
✅ 正确配置路由：三步到位
打开路由配置文件
编辑 app/Config/Routes.php，确保已启用 routes 实例（通常默认已存在）。-
添加你的路由规则
在 $routes->set404Override() 之前，添加如下行（推荐放在静态路由区块末尾）：// app/Config/Routes.php $routes->get('/home', 'Home::index');? 提示：/home 是请求路径，Home::index 表示调用 App\Controllers\Home 类的 index() 方法。路径支持通配符，例如：
$routes->get('/home/(:num)', 'Home::view/$1'); 可匹配 /home/123 并将 123 作为参数传入。 验证控制器命名与命名空间
确保你的控制器类名与文件名严格一致（Home.php → class Home），且继承自 BaseController，命名空间为 App\Controllers —— 你提供的代码完全符合，无需修改。
⚠️ 常见陷阱排查清单
- ❌ 误删或注释了默认首页路由：检查是否意外移除了 $routes->get('/', 'Home::index');，否则 http://localhost/ 也可能失效；
- ❌ 路由顺序错误：若你在通配符路由（如 $routes->get('(:any)', ...)）之后才定义 /home，则该规则永远不会命中；
- ❌ HTTP 重写未启用：虽然你已修改 httpd.conf 指向 public/ 目录，但仍需确认 Apache 的 mod_rewrite 已启用（XAMPP 默认开启），并在 public/.htaccess 中保留原始重写规则；
- ❌ 缓存干扰：CI4 会缓存路由配置。执行以下命令清除缓存，避免旧配置残留：
php spark cache:clear php spark routes
后者可列出当前全部有效路由，快速验证 /home 是否已注册。
Skill Weave Chains — 技能链路由引擎下载开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
✅ 进阶建议：统一前缀 + 路由分组（可选）
为提升可维护性，可将前台路由归入分组：
$routes->group('', ['namespace' => 'App\Controllers'], function ($routes) {
$routes->get('/', 'Home::index');
$routes->get('/home', 'Home::index');
$routes->get('/about', 'Page::about');
});这样既避免重复写命名空间，又便于后期迁移或添加中间件（如 ['filter' => 'auth']）。
总结
CI4 的路由是显式声明式而非隐式约定式。/home 不等于自动调用 Home 控制器——它只是个字符串，必须通过 $routes->get() 显式绑定。完成上述配置后，重启浏览器访问 http://localhost/home，即可正常加载 welcome_message 视图。掌握这一核心逻辑，是你迈出 CI4 开发坚实的第一步。
