去掉index.php后404,核心是重写规则、服务器配置或框架设置三者未对齐:需检查.htaccess是否生效(编码/BOM/ RewriteBase/条件缺失)、Apache是否启用mod_rewrite并设AllowOverride All、CodeIgniter中index_page为空且uri_protocol正确,加index.php能访问则证伪静态环节故障。

去掉 index.php 后出现 404,不是“重写没生效”这么简单,而是多个环节协同失败的结果。核心问题通常出在重写规则、服务器配置或框架设置三者之一没对齐。
检查 .htaccess 是否生效且路径正确
Apache 环境下,.htaccess 是关键入口。常见错误包括:
- 文件未保存为纯文本格式(尤其 Windows 记事本容易加 BOM 或用错编码);
-
RewriteBase设置错误:若项目部署在子目录(如http://localhost/myapp/),RewriteBase必须写成/myapp/,不能是/或留空; - 规则中误用
index.php?/$1(CI 4 推荐用index.php/$1,问号会导致路由解析异常); - 漏掉关键条件:
RewriteCond %{REQUEST_FILENAME} !-f和!-d缺一不可,否则静态资源(CSS/JS 图片)也会被重写到 index.php 导致 404。
确认 Apache mod_rewrite 已启用且 AllowOverride 允许覆盖
仅放 .htaccess 不够,服务器必须允许它起作用:
- 运行
a2enmod rewrite(Linux)或检查httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so前的#是否已去掉; - 虚拟主机配置中,对应项目目录的
<Directory>段必须包含AllowOverride All(不能是None); - 重启 Apache 后再测试,不要只刷新浏览器。
验证 CodeIgniter 配置是否匹配重写结果
即使 URL 看起来干净了,框架内部仍需知道“入口在哪”:
立即学习“PHP免费学习笔记(深入)”;
- 打开
application/config/config.php,确认$config['index_page'] = '';(空字符串,不是null或注释掉); -
$config['uri_protocol']建议设为'REQUEST_URI'或'AUTO',避免因服务器环境差异导致 URI 解析失败; - 如果用了自定义
base_url(),确保它以斜杠结尾(如http://yoursite.com/),否则 JS 拼接 AJAX 路径时会丢掉一级目录,直接 404。
快速定位:临时加回 index.php 测试
这是最有效的判断手段:
- 访问
http://yoursite.com/index.php/welcome—— 如果能正常显示欢迎页,说明控制器、路由、PHP 环境都 OK,问题 100% 出在重写环节; - 如果加
index.php也 404,则先排查控制器是否存在、类名是否匹配文件名、default_controller是否拼写正确; - 注意:URL 中控制器名一律小写(
welcome),即使类名为Welcome,这是 CI 的硬性约定。



















