宝塔面板中PHP 8.4部署框架出现404，主因是Nginx未正确转发请求至index.php；需依次配置伪静态规则、添加try_files指令、绑定PHP 8.4版本、重载Nginx并检查入口文件权限。
当您在宝塔面板中使用 PHP 8.4 环境部署 ThinkPHP、Laravel 或其他支持路由的框架时，访问非根路径（如 /admin、/api/user）返回 404 错误，通常并非 PHP 版本本身不兼容，而是 Nginx 未能正确将请求转发至入口文件。以下是针对性修复该故障的具体操作步骤：
一、配置匹配框架的伪静态规则
宝塔内置伪静态模板未自动适配 PHP 8.4 运行时的 Nginx 行为变更，需手动选择或注入对应框架的重写逻辑，确保所有非静态资源请求均被导向 index.php 处理。
1、进入宝塔面板 → 网站 → 找到目标站点 → 点击“设置”。
2、切换至“伪静态”选项卡。
立即学习“PHP免费学习笔记（深入）”；
3、若为 ThinkPHP 6/8，直接下拉选择 ThinkPHP 模板；若为 Laravel，选择 Laravel；若为自定义框架或模板未生效，清空当前内容，粘贴以下通用规则：
if (!-d $request_filename) { set $rule_0 1$rule_0; }
if (!-f $request_filename) { set $rule_0 2$rule_0; }
if ($rule_0 = "21") { rewrite ^/(.*)$ /index.php/$1 last; }
4、点击“保存”。
二、手动编辑 Nginx 配置补充 try_files 回退
PHP 8.4 下部分 Nginx 版本对 if 判断优化更严格，单靠伪静态规则可能失效；添加 try_files 指令可强制兜底至 index.php，覆盖 history 路由与深层路径场景。
1、在站点设置中点击“配置文件”选项卡。
2、定位到 location / { 区块内部（通常在第 30–50 行之间）。
3、在该区块首行插入以下语句：
try_files $uri $uri/ /index.php?$query_string;
4、确保该行未被注释（即前面无 # 号），且位于 location / { 的第一行位置。
5、保存配置文件。
三、修正 PHP 处理器绑定与版本映射
PHP 8.4 安装后，宝塔不会自动将现有站点切换至该版本，若站点仍绑定旧版 PHP（如 7.4 或 8.0），Nginx 将跳过 PHP 解析阶段，直接返回 404。
1、返回站点“设置”页面 → 切换至“PHP 版本”选项卡。
2、从下拉菜单中选择 PHP-8.4（注意名称含“-8.4”，而非“84”或“8.4.0”）。
3、点击“提交”并等待提示“PHP版本切换成功”。
4、执行命令重启 PHP 服务：service php-fpm-84 restart（如实际服务名为 php-fpm-8.4，请以 ps aux | grep php 查得为准）。
四、重载 Nginx 并验证配置语法
伪静态与 location 修改后若未触发 Nginx 重载，变更不会生效；同时语法错误会导致 Nginx 拒绝启动，间接表现为全站 404。
1、在 SSH 中执行：nginx -t，确认输出包含 “syntax is ok” 和 “test is successful”。
2、若报错，根据提示行号检查配置文件中是否有多余符号、缺失分号或括号不闭合。
3、语法通过后执行：bt reload（宝塔快捷命令）或 systemctl reload nginx。
4、刷新浏览器，测试 /admin、/api/test 等路由路径是否正常响应。
五、检查入口文件路径与权限一致性
PHP 8.4 默认启用更严格的 open_basedir 限制与文件路径校验，若 index.php 不在 root 指向目录下，或 www 用户无执行权限，Nginx 将拒绝代理至 PHP-FPM，返回 404 而非 500。
1、在站点“设置”→“基本”中核对“网站目录”路径，例如 /www/wwwroot/example.com。
2、通过 SSH 进入该目录：cd /www/wwwroot/example.com。
3、执行：ls -l index.php，确认文件存在且权限为 644。
4、执行：ls -ld .，确认目录权限为 755，所属用户组为 www:www。
5、若不符，依次执行：chown -R www:www /www/wwwroot/example.com 与 chmod -R 755 /www/wwwroot/example.com。
