CodeIgniter404错误排查与路由设置

CodeIgniter 中绝大多数404错误并非代码逻辑问题，而是路由“根本没进框架”——根源在于入口配置（$config['index_page'] = ''）与Web服务器重写规则（Apache的.htaccess或Nginx的try_files）未正确协同，加上大小写敏感的命名约定（URL小写→控制器类名首字母大写）、路由配置误写、开发服务器局限及缓存干扰等隐性陷阱；本文直击90%真实生产环境404的共性症结，提供可立即验证的排查清单，帮你绕过玄学调试，三分钟定位到底是服务器没转发、文件名写错，还是路由悄悄覆盖了默认解析。

CodeIgniter 页面 404，90% 是路由没接上——不是控制器写错了，而是请求压根没进框架。

确认 $config['index_page'] 和重写是否协同工作

CodeIgniter 默认用 index.php 作入口，清空它（$config['index_page'] = '';）后，必须靠 Web 服务器把所有非静态资源请求转给 index.php。两者不匹配，直接 404。

• Apache 下检查 .htaccess 是否存在且生效：重点看 RewriteCond %{REQUEST_FILENAME} !-f 和 RewriteCond %{REQUEST_FILENAME} !-d 这两行是否在 RewriteRule 前；RewriteRule ^(.*)$ index.php/$1 [L] 中的 /$1 不能漏掉斜杠（否则 URI 段落丢失）
• Nginx 用户跳过 .htaccess，直接改 server 块：try_files $uri $uri/ /index.php?$query_string; 必须存在，且 root 指向的是 public 或项目根目录下的 index.php 所在路径
• 用浏览器访问 http://yourdomain.com/index.php/welcome 能打开，但 http://yourdomain.com/welcome 404？说明重写失败，不是代码问题

验证控制器文件名、类名、方法名三者大小写与约定

CodeIgniter 对大小写敏感，且强制小写 URL 映射到首字母大写的类——这个隐式规则是 404 最隐蔽的来源之一。

• URL 中的控制器段必须全小写：/user/profile → 对应 User.php 文件，类名为 User，方法为 profile()
• 文件名 User.php 若写成 user.php（Linux 环境下）或 USER.PHP（Windows 可能侥幸通过），部署到 Linux 服务器就 404
• 方法名不能是 PHP 魔术方法（如 __construct 以外的双下划线开头），也不能是 private；public function index() 是默认触发点，但若路由指向其他方法，该方法必须存在且可调用

检查 routes.php 是否覆盖了默认行为

自定义路由写错，会屏蔽默认的「控制器/方法」自动解析逻辑，导致看似正确的 URL 实际无匹配。

• $route['default_controller'] = 'welcome'; 中的 welcome 必须对应 application/controllers/Welcome.php，类名 Welcome，且含 index() 方法
• 写 $route['blog'] = 'post/index'; 没问题，但若写成 $route['blog'] = 'Post/index';（类名首字母大写），CodeIgniter 3.x 会找不到——路由值里的控制器名必须小写
• 启用 $route['404_override'] = 'errors/not_found'; 后，所有未匹配路由都会进这个控制器，此时要确认 Errors.php 存在、not_found() 方法存在，否则可能引发二次 404 或白屏

排除开发服务器和环境配置干扰

PHP 内置服务器（php -S）完全不读 .htaccess，也不支持 Apache/Nginx 的重写逻辑，本地调试时切勿依赖它跑 CodeIgniter。

• 运行 php -S localhost:8000 router.php 并不能替代 Apache/Nginx；router.php 需手动解析 $_SERVER['REQUEST_URI']，且 CodeIgniter 默认不提供该文件
• 检查 $config['uri_protocol']：推荐先设为 'AUTO'，若无效再试 'REQUEST_URI'；设为 'QUERY_STRING' 会导致 index.php?/user 这种形式才有效，日常不用
• 移动设备访问本地项目 404？大概率是用了 php -S，或者 host 配置没同步（如 127.0.0.1 myapp.test 在手机上不生效），换真机搭 Apache 或使用 ngrok 代理更可靠

最常被忽略的一点：修改 .htaccess 或 Nginx 配置后，只重启 PHP-FPM 不够，必须重启整个 Apache 或 Nginx 进程；而 CodeIgniter 的路由缓存（CI 4）或配置加载顺序（CI 3）也可能导致改动不即时生效——清空 application/cache/ 和浏览器缓存再试。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~