CodeIgniter 4 默认禁用基于文件路径的传统 URI（如 /index.php/Home），必须通过显式路由注册控制器方法，否则将触发 404；正确配置命名空间、路由映射与 URL 访问方式是关键。
codeigniter 4 默认禁用基于文件路径的传统 uri（如 `/index.php/home`），必须通过显式路由注册控制器方法，否则将触发 404；正确配置命名空间、路由映射与 url 访问方式是关键。
在 CodeIgniter 4 中，不再支持 CodeIgniter 3 风格的自动控制器解析（即 index.php/ControllerName/Method）。你看到的 404 — Controller or its method is not found 错误，根本原因在于：CI4 的路由系统默认关闭了“自动路由”（Auto Routing），且控制器类名、命名空间和路由定义必须严格匹配。
✅ 正确做法：显式定义路由 + 规范控制器结构
首先，确保你的控制器符合 CI4 命名规范：
// app/Controllers/HomeController.php
<?php namespace App\Controllers;
use CodeIgniter\Controller;
class HomeController extends BaseController
{
public function index()
{
return view('home'); // 或 echo 'Home page';
}
}⚠️ 注意：
- 类名必须以
Controller结尾（如HomeController）；- 必须声明
namespace App\Controllers;；- 继承
BaseController（而非Controller）；- 方法应返回内容（不推荐直接
echo，建议使用return view()或return $this->response->setBody()）。
接着，在 app/Config/Routes.php 中显式注册路由：
// app/Config/Routes.php
$routes->get('/', 'HomeController::index'); // 根路径 → HomeController@index
$routes->get('home', 'HomeController::index'); // /home → HomeController@index
$routes->get('home/contact', 'HomeController::contact'); // /home/contact → HomeController@contact✅ 推荐：启用「命名空间感知的自动路由」（可选增强）
若希望保留部分传统习惯（如/home自动映射到HomeController），可在Routes.php开启 Auto Routing Improved（需确保$routes->setAutoRoute(true)已启用，且控制器位于App\Controllers下）：$routes->setAutoRoute(true);但请注意：即使开启，也仅支持
/{controller}和/{controller}/{method}形式（无index.php前缀），且要求控制器类名严格为XxxController。
在SEO发布前，从路由清单生成XML网站地图和robots.txt下载当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
? 访问 URL 的正确方式（无需 index.php）
CI4 强烈推荐启用 Apache/Nginx 重写，直接访问干净 URL：
http://localhost/CI4/public/ → 默认路由（如 '/'） http://localhost/CI4/public/home → 映射到 HomeController::index http://localhost/CI4/public/home/contact → 映射到 HomeController::contact
? 确保已启用重写模块：
- Apache：确认
.htaccess在public/目录下且mod_rewrite已启用；- Nginx：需配置
try_files $uri $uri/ /index.php?$query_string;；- Windows XAMPP/MAMP：通常默认支持，若仍跳转失败，请检查
public/.htaccess是否生效。
❌ 常见错误排查清单
- ☐ 访问
index.php/Home—— CI4 不识别此格式，必须删除index.php并走路由； - ☐ 控制器未放在
app/Controllers/下或命名空间错误（如漏写App\Controllers\）； - ☐ 路由定义未保存或缓存未清除（运行
php spark routes查看当前有效路由）； - ☐ 使用了
get()但请求是 POST（应改用$routes->match(['get', 'post'], ...)）； - ☐
public/index.php被手动修改过（请勿改动该文件，所有配置应在app/Config/下完成）。
? 总结
CodeIgniter 4 的路由是「显式优先、安全可控」的设计哲学体现。放弃对 index.php/Controller/Method 的依赖，转而通过 Routes.php 精确声明每个端点，不仅能避免 404，还能提升安全性、可维护性与 RESTful 兼容性。从今天起，请牢记三要素：正确命名空间 + 显式路由注册 + 清洁 URL 访问。
