FastAdmin在phpEnv下404的主因是站点根目录未指向public目录且伪静态规则未生效。需将网站目录设为public、关闭防跨站、确保deny_module_list未禁用admin、手动配置AllowOverride All并粘贴正确Rewrite规则。

phpEnv 下 FastAdmin 站点无法访问后台或前台路由 404,基本就是 public 目录没设对 + 伪静态规则没生效,二者缺一不可。
phpEnv 站点根目录必须指向 public 目录
FastAdmin 是基于 ThinkPHP 的框架,入口文件 index.php 不在项目根目录,而在 public 子目录下。phpEnv 默认把站点根目录设为整个项目文件夹(比如 D:\phpEnv\www\fastadmin),这会导致 Apache 直接尝试加载 fastadmin/index.php,而它根本不存在——实际路径是 fastadmin/public/index.php。
正确做法:
- 在 phpEnv 控制面板中,选中你的站点 → “网站设置” → “网站目录” → 修改为
D:\phpEnv\www\fastadmin\public(Windows)或对应 Linux 路径 - 务必取消勾选“防跨站攻击”,否则
.htaccess会被拦截,伪静态失效 - 确认
public目录下存在.htaccess文件,且内容与 FastAdmin 官方一致(含RewriteEngine On和匹配逻辑)
phpEnv 的伪静态配置不能只靠 .htaccess
phpEnv 底层用的是 Apache,但它的控制面板对 .htaccess 支持不完全稳定——尤其在 Windows 下,即使 mod_rewrite 已启用、AllowOverride All 已配置,仍常出现规则不触发的情况。
立即学习“PHP免费学习笔记(深入)”;
更可靠的做法是:绕过 .htaccess,直接在 phpEnv 的“伪静态”配置框里粘贴规则:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
注意三点:
- 不要加
<IfModule mod_rewrite.c>包裹,phpEnv 的伪静态框不识别这个语法,加了反而报错或失效 - 末尾的
[QSA,PT,L]必须保留,PT(pass-through)确保 ThinkPHP 路由能正确解析 PATH_INFO - 如果站点绑定了子目录(如
http://localhost/fastadmin),需在RewriteRule中补上前缀:RewriteRule ^(.*)$ /fastadmin/index.php?/$1 [QSA,PT,L]
常见 404 场景与对应检查点
不是所有 404 都是伪静态问题,得快速定位:
- 首页能打开,但点“后台登录”跳
/admin报 404 → 90% 是伪静态未生效,检查上一条中的规则是否粘贴进 phpEnv 伪静态框并保存 - 首页也 404 → 先确认 phpEnv 是否监听了正确端口(默认 80/8080),再检查“网站目录”是否真指向了
public,最后看public/index.php文件是否存在且可读 - 后台能进,但上传图片失败或富文本保存报错 → 可能是
runtime目录权限问题,phpEnv 下需手动给runtime(位于项目根目录)设写入权限(右键 → 属性 → 安全 → 编辑 → 添加 Users 或 IIS_IUSRS 并勾选“写入”)
deny_module_list 会屏蔽后台访问路径
FastAdmin 安装后默认在 application/config.php 中禁用了 admin 模块:
'deny_module_list' => ['common','admin'],
这意味着即使伪静态和目录都正确,直接访问 /admin 也会被框架内部拦截返回 404。这不是服务器错误,而是框架级拒绝。
临时解决办法(仅开发阶段):
- 打开
application/config.php - 将
'admin'从deny_module_list数组中移除,或整行注释掉 - 保存后清空
runtime/cache目录(否则配置不生效)
生产环境请勿这样做,应使用安装时生成的随机后台入口(如 /eEmduvLTSq.php),它不受 deny_module_list 限制。
最易被忽略的其实是 AllowOverride All 在 phpEnv 虚拟主机配置里的缺失——它藏在 Apache 的 vhosts.conf 或 httpd-vhosts.conf 里,而 phpEnv 控制面板不提供图形化编辑入口,必须手动改配置文件并重启 Apache。这点一旦漏掉,前面所有伪静态操作都白忙。



















