PHP项目404错误解决方法大全

小伙伴们对文章编程感兴趣吗？是否正在学习相关知识点？如果是，那么本文《PHP项目404错误解决方法【要点】》，就很适合你，本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点，希望对大家的知识积累有所帮助！

PHP项目上线404主因是Web服务器未正确转发请求，需依次排查：Apache检查mod_rewrite、.htaccess、AllowOverride；Nginx核对location、fastcgi_pass、root及try_files；再查PHP-FPM状态、权限与SELinux；最后确认框架入口路径与大小写。

PHP项目上线后出现404，绝大多数情况不是代码写错了，而是Web服务器没把请求正确转发给PHP处理——先查服务器配置，再看路由和重写规则。

Apache下index.php不生效或伪静态失效

常见现象：访问 https://example.com/ 返回404，但直接访问 https://example.com/index.php 能正常打开；或者 Laravel、ThinkPHP 的路由（如 /user/profile）全部 404。

• 确认 .htaccess 文件已上传且未被忽略（尤其是 Git 忽略了隐藏文件）
• 检查 Apache 是否启用了 mod_rewrite：

  a2enmod rewrite

  并重启服务
• 确保虚拟主机配置中 AllowOverride 设置为 All（不能是 None）：

  
      AllowOverride All
      Require all granted
  

• 若用的是 Apache 2.4+，Order allow,deny 类旧语法已失效，必须改用 Require all granted

Nginx下PHP文件返回404而非执行

典型错误：Nginx 把 /index.php 当作静态文件找，找不到就 404；根本没交给 php-fpm 处理。

• 确认 location ~ \.php$ 块存在且位置正确（通常在 server 块内），且包含 fastcgi_pass 指向正确的 php-fpm socket 或端口
• 关键参数不能漏：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; —— 缺失会导致 PHP 找不到脚本路径
• 检查 root 指令是否指向项目真实根目录（比如 /var/www/myapp/public），而不是上层目录
• 伪静态需显式配置：Laravel 常用的 try_files $uri $uri/ /index.php?$query_string; 必须写在 location / 块里

PHP-FPM或权限导致的“找不到文件”假404

现象看似 404，实则是 Nginx/Apache 收到 PHP-FPM 返回的空响应或 403，最终回退成 404；日志里可能看到 connect() failed (111: Connection refused) 或 Permission denied。

• 确认 php-fpm 服务正在运行：

  systemctl status php*-fpm

  （版本号要匹配，如 php8.1-fpm）
• 检查 listen 配置（/etc/php/*/fpm/pool.d/www.conf）是否与 Nginx 中的 fastcgi_pass 一致（127.0.0.1:9000 还是 /run/php/php8.1-fpm.sock）
• 确认 Web 服务器用户（如 www-data 或 nginx）对项目目录有读+执行权限：

  chmod -R 755 /var/www/myapp

  ，尤其 public/ 和 storage/ 目录
• SELinux 启用时会拦截 socket 访问，临时验证可运行：

  setenforce 0

  （仅调试，勿长期关闭）

框架路由/入口文件路径配置错误

即使 Web 服务器配置全对，框架自身也可能因路径错乱返回 404，尤其部署时修改过目录结构。

• Laravel：确认 public/index.php 是唯一入口，且 APP_URL 和 ASSET_URL 在 .env 中指向正确域名（不要带 /public）
• ThinkPHP：检查 public/index.php 中的 define('BASE_PATH', __DIR__ . '/../'); 是否准确；URL 模式开启需对应 Web 服务器重写规则
• 自定义入口：如果把 index.php 移到了子目录（如 /blog/index.php），则 Web 服务器的 root 或 Alias 必须同步调整，否则 $document_root 解析错误
• 注意大小写：Linux 文件系统区分大小写，Index.php ≠ index.php，上传工具自动改名可能导致 404

真正卡住的地方往往不在 PHP 代码里，而在 Web 服务器对 URI 的解析链条上：从域名 → 虚拟主机 → root 路径 → 重写规则 → 入口文件 → 路由分发。每一步都得对得上，漏一个环节，就 404。

到这里，我们也就讲完了《PHP项目404错误解决方法大全》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！