本地搭建Laravel环境后运行代码出现404错误,登录跳转首页仍报错
Laravel本地运行全页面404问题排查指南
- 修正Web服务器根目录配置:所有Web服务器(Apache、Nginx、phpStudy、XAMPP等集成环境)的站点根目录,必须指向Laravel项目目录下的
public文件夹,不能直接指向项目最外层的根目录。根目录指向错误是本地开发出现全页面404的最常见原因,会导致所有路由请求都无法匹配到入口文件index.php。 - 校验伪静态规则配置
- Nginx环境:确认站点配置里包含核心重写规则
try_files $uri $uri/ /index.php?$query_string;,缺失该规则会导致所有非静态资源请求直接报路径不存在。 - Apache环境:确认已开启
mod_rewrite模块,且public目录下的.htaccess文件未被删除、修改。
- Nginx环境:确认站点配置里包含核心重写规则
- 内置服务启动校验:如果使用Laravel自带的
php artisan serve命令启动开发服务,确认是在项目根目录执行的命令,访问地址必须和命令行输出的地址一致,不要手动修改端口、跳转到未监听的路径。 - 清理旧的缓存配置:在项目根目录依次执行以下命令,清除旧的路由、配置、视图缓存,避免缓存错位导致的404:
php artisan route:clearphp artisan config:clearphp artisan view:clearphp artisan cache:clear
- 核对路由定义:确认需要访问的页面路由是定义在
routes/web.php文件中,不要将web端访问的路由写到routes/api.php等其他路由文件里,避免路径匹配失败。 - 校验登录重定向逻辑:确认登录成功后跳转的路径,和
web.php中定义的对应路由完全一致,不存在拼写错误、路径不匹配的问题。比如默认认证脚手架的跳转路径为/dashboard,如果手动修改过重定向地址,要确保该路径有对应的路由映射。 - 子路径部署适配:如果项目没有放在域名/服务的根目录下,而是部署在二级子路径中,需要在
.env文件中配置正确的APP_URL,并给路由加上对应的路径前缀,避免路径匹配错位。
内容的提问来源于stack exchange,提问作者sabia tasleem
相关产品推荐
相关产品推荐

