PHP部署404错误解决方法大全

PHP项目部署后出现404错误，往往并非代码问题，而是Web服务器配置的几个关键环节出了偏差：最常见的是服务器根目录未正确指向框架要求的public子目录，其次是PHP解析模块未启用或配置失效导致脚本无法执行，再者是URL重写规则缺失或未生效致使路由无法统一入口。无论是Apache还是Nginx，都需要精准校验DocumentRoot/root路径、PHP处理器关联、重写指令（如try_files或mod_rewrite）以及相关权限设置（如AllowOverride），三者任一疏漏都可能引发看似404实则源于配置断层的“假性丢失”，快速定位需结合curl响应头、info.php验证和重写测试三步交叉排查。

检查 Web 服务器是否正确指向 PHP 项目根目录

404 最常见原因是 Web 服务器（如 Apache 或 Nginx）的 DocumentRoot（Apache）或 root（Nginx）没指向你放 index.php 的实际目录。比如你把项目放在 /var/www/myapp，但服务器配置仍指向 /var/www/html，就会直接 404。

• Apache：确认 DocumentRoot 和 路径一致，且该目录下存在 index.php
• Nginx：检查 server 块中的 root 指令，确保路径末尾**不带斜杠**（如 root /var/www/myapp;，不是 /var/www/myapp/;）
• 重启服务后用 curl -I http://localhost 看响应头，确认状态码是否变化

确认 PHP 文件能被 Web 服务器解析而非直接下载

如果访问 index.php 时浏览器直接下载文件，或返回原始 PHP 代码，说明 PHP 模块未启用或未正确关联 .php 后缀——此时 Web 服务器根本没执行 PHP，自然无法路由到控制器，也常表现为“看似 404”（其实是 200 返回了空内容或源码）。

• Apache：确认已加载 libphp.so（或 php_module），且 AddHandler application/x-httpd-php .php 已配置
• Nginx：确认 location ~ \.php$ 块存在，并正确将请求代理给 fastcgi_pass（如 127.0.0.1:9000 或 unix:/var/run/php/php8.1-fpm.sock）
• 运行 php -v 和 systemctl status php8.1-fpm（或对应版本）确认 PHP-FPM 正在运行

检查 Laravel / Symfony 等框架的重写规则是否生效

现代 PHP 应用依赖 URL 重写把所有请求统一交给 index.php 处理。若重写失效，除 index.php 外的路径（如 /login、/api/users）都会 404。

• Laravel：Apache 需启用 mod_rewrite，且项目根目录下的 .htaccess 文件必须存在且未被覆盖；Nginx 则需在 location / 块中加入 try_files $uri $uri/ /index.php?$query_string;
• Symfony：同理，Nginx 推荐用 try_files $uri /index.php?$query_string;，避免多一层 $uri/ 导致子目录匹配异常
• 测试方法：临时在 index.php 开头加 ，再访问任意路径（如 /test）。如果输出 hit，说明重写生效；否则仍是 404，问题在重写配置

验证 public 目录是否被误设为项目根目录上级

很多框架（Laravel、Lumen、Symfony）要求 Web 服务器的根目录必须是 public/，而不是项目根目录。如果错误地把 /var/www/myapp 设为 DocumentRoot，而真实入口是 /var/www/myapp/public/index.php，那么除 /public/index.php 外所有路径都不可达。

• 正确做法：Apache 设置 DocumentRoot "/var/www/myapp/public"；Nginx 设置 root /var/www/myapp/public;
• 常见陷阱：部署时复制整个项目，但忘记调整 Web 服务器配置指向 public 子目录
• 可临时加一个 info.php 到 public/ 下，内容为 ，通过 http://yoursite/info.php 验证路径和 PHP 是否就绪

最易忽略的是：重写规则和 public/ 路径这两个点经常同时出错，排查时别只盯一个。比如 Nginx 配置对了 root，但漏了 try_files；或者 .htaccess 写对了，但 Apache 的 AllowOverride All 没开在对应 块里——这两类权限与规则叠加问题，比单纯路径错更难一眼发现。

今天关于《PHP部署404错误解决方法大全》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！