应先查看 web 服务器访问日志，通过 tail -f 观察请求状态码与响应时间，若为 404 且响应极短，说明请求未到达 php-fpm 而被 apache/nginx 直接拦截返回。
确认 Apache/Nginx 是否真正转发到 PHP-FPM
很多“多模块 404”其实根本没进 PHP，而是 Web 服务器直接返回了 404。先看访问日志：tail -f /var/log/apache2/access.log 或 tail -f /var/log/nginx/access.log，触发一次请求，观察状态码是不是 404，且 response time 极短（
重点检查：
- Apache：确认
mod_rewrite已启用，且.htaccess中的RewriteRule是否匹配到模块路径（比如^admin/(.*)$）；RewriteBase设置是否与实际 URL 前缀一致 - Nginx：检查
location ~ \.php$块是否覆盖了模块路径（如/api/或/backend/），常见错误是fastcgi_param SCRIPT_FILENAME拼错，例如写成$document_root$fastcgi_script_name却没处理重写后的路径，导致 PHP 找不到入口文件
检查 PHP 入口文件是否被正确路由到模块逻辑
即使请求进了 PHP，如果框架或路由没识别模块前缀，也会抛出 404。以 Laravel、ThinkPHP、CodeIgniter 等主流框架为例：
- Laravel：确认
APP_URL和asset()渲染的路径与实际部署路径一致；子模块若通过子域名（如admin.example.com）部署，需检查Route::domain()配置；若用目录前缀（如example.com/backend/），必须在public/index.php上方手动设置$_SERVER['SCRIPT_NAME'] = '/backend/index.php'; - ThinkPHP：查看
config/app.php中的app_subdomain_deploy和app_domain_bind，目录部署时重点核对url_pathinfo_depr和url_html_suffix是否干扰路由解析 - 原生 PHP：检查
$_SERVER['REQUEST_URI']是否含模块前缀（如/cms/login.php），而入口文件（index.php）是否做了substr($_SERVER['REQUEST_URI'], 0, 4) === '/cms'这类硬判断，但没相应分发逻辑
验证 public 目录结构与 Web 根目录映射关系
多模块常采用“共享 vendor + 独立 public”的结构，典型错误是 Web 服务器根目录指向项目根（/var/www/myapp），而非各模块的 public 子目录（/var/www/myapp/admin/public）。
立即学习“PHP免费学习笔记（深入）”；
执行以下命令快速验证：
ls -l /var/www/myapp/admin/public/index.php ls -l /var/www/myapp/api/public/index.php
若存在，再确认 Web 配置中对应 location 的 root（Nginx）或 DocumentRoot（Apache）是否精确指向这些 public 目录，而不是统一指向顶层 /var/www/myapp。否则所有请求都会因找不到 index.php 而 404。
开启 PHP 错误与路由调试开关
别依赖浏览器 404 页面——它可能是框架自己 render 的，掩盖真实错误。临时修改入口文件顶部：
<?php
error_reporting(E_ALL);
ini_set('display_errors', '1');
// ThinkPHP 加这行：
define('APP_DEBUG', true);
// Laravel 加这行：
putenv('APP_DEBUG=true');
// 原生路由调试：打印原始路径
var_dump($_SERVER['REQUEST_URI'], $_SERVER['SCRIPT_NAME'], $_SERVER['PATH_INFO']);
die;
这样能立刻看到请求到底被解析成什么路径，有没有被重写截断、有没有多出斜杠、大小写是否不一致（Linux 文件系统区分大小写！/Admin/ ≠ /admin/）。
模块间共用 autoload 时，还要留意 composer dump-autoload -o 是否执行成功，否则类找不到也会静默 404（尤其在生产环境关闭错误显示时）。
最常被忽略的是：Web 服务器配置里开了 try_files $uri $uri/ /index.php?$query_string，但模块路径下没有对应的 index.php，或者 index.php 权限为 600 导致 PHP-FPM 无法读取。
