404最常见原因是Web服务器未正确指向PHP项目根目录或public子目录。需检查DocumentRoot（Apache）或root（Nginx）路径是否准确、PHP模块是否启用、重写规则是否生效，以及框架要求的public目录是否被正确设为Web根目录。
检查 Web 服务器是否正确指向 PHP 项目根目录
404 最常见原因是 Web 服务器（如 Apache 或 Nginx）的 DocumentRoot（Apache）或 root（Nginx）没指向你放 index.php 的实际目录。比如你把项目放在 /var/www/myapp，但服务器配置仍指向 /var/www/html，就会直接 404。
- Apache：确认
DocumentRoot和<directory></directory>路径一致，且该目录下存在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开头加<?php die('hit'); ?>，再访问任意路径（如/test）。如果输出hit，说明重写生效；否则仍是 404，问题在重写配置
验证 public 目录是否被误设为项目根目录上级
很多框架（Laravel、Lumen、Symfony）要求 Web 服务器的根目录必须是 public/，而不是项目根目录。如果错误地把 /var/www/myapp 设为 DocumentRoot，而真实入口是 /var/www/myapp/public/index.php，那么除 /public/index.php 外所有路径都不可达。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：Apache 设置
DocumentRoot "/var/www/myapp/public"；Nginx 设置root /var/www/myapp/public; - 常见陷阱：部署时复制整个项目，但忘记调整 Web 服务器配置指向
public子目录 - 可临时加一个
info.php到public/下，内容为<?php phpinfo(); ?>，通过http://yoursite/info.php验证路径和 PHP 是否就绪
最易忽略的是：重写规则和 public/ 路径这两个点经常同时出错，排查时别只盯一个。比如 Nginx 配置对了 root，但漏了 try_files；或者 .htaccess 写对了，但 Apache 的 AllowOverride All 没开在对应 <directory></directory> 块里——这两类权限与规则叠加问题，比单纯路径错更难一眼发现。
