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-fpmsocket 或端口 - 关键参数不能漏：
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免费学习笔记（深入）”；
- 确认
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。