PHP MVC架构在共享CPanel上404报错，本地及VPS的CPanel正常

结合你描述的情况——本地和VPS CPanel正常、仅共享CPanel主机非根路径404，且控制器视图逻辑无问题，重点从以下几个方向排查：

1. 优先检查public目录下的.htaccess配置 #

共享主机的Apache规则限制较多，这是最常见的原因：

• 确保mod_rewrite模块已开启（可通过phpinfo()查看，或联系主机商确认）
• 替换为适配共享主机的.htaccess规则（放在public目录下）：

  RewriteEngine On
  # 若public是站点根目录则设为/，若项目在子目录（如example.com/myapp/）则改为/myapp/
  RewriteBase /
  # 跳过实际存在的文件/目录（避免静态资源被重定向）
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  # 将所有请求转发到index.php处理
  RewriteRule ^(.*)$ index.php [L,QSA]
  

• 确认主机的AllowOverride设置：若你有权限修改虚拟主机配置，需将对应目录的AllowOverride设为All；若无权限，联系主机商开启AllowOverride FileInfo以上的权限

2. 验证Composer自动加载是否正常 #

• 检查public/index.php开头是否正确引入自动加载文件：

  require __DIR__ . '/../vendor/autoload.php';
  

• 登录共享主机终端，进入项目根目录执行composer dump-autoload，重新生成类映射文件——共享主机的文件权限可能导致自动加载缓存异常

3. PHP.ini配置排查 #

• 调试$_SERVER变量：在index.php最顶部添加代码，查看URL参数是否被正确传递：

  var_dump($_SERVER['REQUEST_URI'], $_SERVER['PATH_INFO']);
  exit;
  

  部分共享主机会隐藏REQUEST_URI，此时可改用PATH_INFO作为路由解析的依据
• 检查open_basedir设置：若该选项限制了访问项目根目录，会导致控制器类无法加载，可通过phpinfo()查看，或联系主机商调整
• 确认display_errors开启，方便查看是否有类加载失败的报错

4. 路由逻辑调试 #

• 在Router类中添加调试代码，打印当前解析的URL和匹配的路由规则：

  // 在路由匹配前添加
  error_log('当前请求URI: ' . $_SERVER['REQUEST_URI']);
  

  部分共享主机的站点可能部署在子目录下（如https://yourdomain.com/hosting-subdir/），此时你的路由规则需要先去除该前缀，才能正确匹配

内容的提问来源于stack exchange，提问作者ferva