Laravel 8在cPanel运行正常，本地配虚拟主机后路由404如何解决

cPanel本质是面向共享主机的Web服务集成管理面板，底层基于Apache/Nginx运行，它实现Laravel直接运行的逻辑非常简单：

• 直接将站点的文档根目录绑定到Laravel项目的public子目录，而非项目根目录
• 默认开启Web服务的URL重写模块，授权public目录下的站点级重写规则生效，让所有非静态资源的请求统一转发到Laravel的入口文件index.php
• 整个过程不需要运行php artisan serve，因为这个命令本质是启动PHP内置的临时开发服务器，cPanel用常驻的Apache直接处理请求，运行效率远高于内置开发服务。

你目前遇到的“首页可访问、其他路由404”的问题，属于配置环节遗漏关键权限导致，和Laravel项目代码本身无关：

1. Apache的URL重写模块未加载
2. 虚拟主机配置未给public目录开放站点级.htaccess文件的生效权限
   Laravel的public目录下自带了用于路由转发的.htaccess规则，只要权限配置正确，不需要手动编写额外重写规则，就能实现所有路由的正常解析。

首页能正常访问的原因是：访问域名根路径时，Apache默认会自动查找目录下的index.php作为响应文件，这一过程不需要触发重写规则；而访问/posts这类路径时，Apache会直接在磁盘上查找对应名称的实体文件/文件夹，找不到就抛出404，根本不会走到Laravel的路由解析流程。

• 第一步：开启Apache重写模块
  打开XAMPP安装目录下的apache/conf/httpd.conf文件，找到#LoadModule rewrite_module modules/mod_rewrite.so这一行，删除行首的注释符号#，保存文件。
• 第二步：修正虚拟主机的权限配置
  打开apache/conf/extra/httpd-vhosts.conf，找到你为Laravel项目配置的虚拟主机块，参考以下示例补全目录权限配置，重点是设置AllowOverride All，让public目录下的.htaccess规则能够生效：

  <VirtualHost *:80>
      # 替换为你本地Laravel项目public目录的实际路径
      DocumentRoot "C:/xampp/htdocs/laravel8/public"
      # 替换为你在hosts文件中配置的本地域名
      ServerName laravel8.local
      <Directory "C:/xampp/htdocs/laravel8/public">
          Options Indexes FollowSymLinks
          # 关键配置：允许目录下的.htaccess重写规则生效
          AllowOverride All
          # 开放目录访问权限
          Require all granted
      </Directory>
  </VirtualHost>
  

• 第三步：检查public目录下的.htaccess文件完整性
  确认public目录下的.htaccess文件存在，且为Laravel默认生成的内容——核心逻辑是当请求的路径对应不到磁盘上的实际文件/文件夹时，自动转发到index.php做路由解析。如果文件缺失，可以从同版本Laravel项目中复制默认内容到该文件。
• 第四步：重启XAMPP中的Apache服务，再测试所有路由的访问效果，此时表现会和远程cPanel环境完全一致。

内容的提问来源于stack exchange，提问作者Pedro Magalhães