Web服务器未正确配置PHP解析会导致.php文件返回404而非PHP错误；需检查模块启用、MIME类型、location路由、PHP-FPM连接及路径权限。
检查 Web 服务器是否真的在运行 PHP 而不是只返回静态文件
很多“404”其实根本不是 PHP 报的，而是 Web 服务器（如 Apache 或 Nginx）压根没把 .php 文件交给 PHP 解析器处理，直接当成不存在的静态资源返回了 404。典型表现是：访问 index.html 正常，但 index.php 404；或者浏览器地址栏显示 http://localhost/test.php，但响应头里 Content-Type 是 text/html 而不是 PHP 输出的内容。
- Apache：确认启用了
mod_php（或php_module），且配置中有类似AddType application/x-httpd-php .php和<filesmatch></filesmatch>段落 - Nginx：确认
location ~ \.php$块存在，并正确将请求代理给fastcgi_pass（如127.0.0.1:9000或unix:/var/run/php/php8.1-fpm.sock） - 用命令快速验证 PHP 是否就绪：
php -v
（看 CLI 是否正常），再执行php -S localhost:8000
启动内置服务器，访问http://localhost:8000/test.php—— 如果这时能显示内容，说明是 Web 服务器配置问题，不是 PHP 本身
确认请求路径和文件物理位置完全匹配
PHP 不会“猜路径”，404 最常见原因是 URL 路径与服务器上真实文件路径不一致，尤其容易在重写规则、虚拟主机或子目录部署时出错。
- 不要依赖 IDE 或编辑器的“在浏览器中打开”功能，它可能用的是
file://协议，绕过 Web 服务器 → 一定要用http://开头的地址访问 - 在 PHP 文件开头加一句：
<?php die(__FILE__); ?>
，访问后看输出的绝对路径，对比你认为它该在的位置，确认是否少了一级目录（比如项目放在/var/www/html/myapp/，但你访问的是/myapp/index.php，而服务器配置的 root 是/var/www/html） - Apache 的
DocumentRoot和 Nginx 的root指令必须指向包含.php文件的父目录，不能指向更深的子目录却没配对的location或Alias
排查 .htaccess 或 Nginx 重写规则干扰
URL 重写（尤其是 Laravel、WordPress 等框架常用）一旦配置错误，会导致 PHP 脚本被重定向到不存在的路径，最终由 Web 服务器返回 404。
- Apache 下临时禁用
.htaccess：把AllowOverride改为None，或重命名.htaccess文件，再试访问原始 PHP 文件（如/info.php） - Nginx 中注释掉整个
location ~ \.php$ { ... }块以外的重写逻辑（如try_files $uri $uri/ /index.php?$query_string;），改用最简配置直通 PHP，排除干扰 - 开启 Web 服务器的重写日志（Apache：
RewriteLog+RewriteLogLevel；Nginx：rewrite_log on;）可看到每一步跳转，定位哪条规则意外截断了请求
检查 PHP-FPM 是否监听正确地址且有权限访问
Nginx 常见报错是 connect() to unix:/var/run/php/php8.1-fpm.sock failed (13: Permission denied)，表面是 404，实际是 Nginx 根本连不上 PHP-FPM，于是降级返回 404（而非 502）。
立即学习“PHP免费学习笔记（深入）”；
- 确认 PHP-FPM 进程正在运行：
systemctl status php8.1-fpm
（版本号按实际调整） - 检查
listen配置项（通常在/etc/php/8.1/fpm/pool.d/www.conf）：如果是unix套接字，确认 Nginx worker 进程用户（如www-data）对该 socket 文件有读写权限；如果是127.0.0.1:9000，确认端口未被占用且防火墙放行 - 用
ls -l /var/run/php/查看 socket 文件属主和权限，必要时修改listen.owner/listen.group并重启 PHP-FPM
真正卡住的地方往往不在 PHP 代码里，而在 Web 服务器和 PHP-FPM 之间的那层连接——路径、权限、协议、用户上下文，四者缺一不可。调不通时，先砍掉所有中间层（重写、缓存、CDN），用最裸的配置跑一个 phpinfo()，再一层层加回来。
