本文旨在解决laravel项目中常见的路由404错误，特别是当url中出现“public”路径段时。核心在于强调laravel应用应通过内置开发服务器或正确配置web服务器（将文档根指向项目public目录）来访问，而非直接在url中包含“public”，从而确保请求能正确送达laravel路由处理器。
理解Laravel路由与URL结构
Laravel框架的设计核心之一是将所有HTTP请求都通过一个统一的入口文件——public/index.php来处理。这意味着无论你访问 /、/about 还是 /products/1，最终都应该由 public/index.php 接收请求，然后Laravel的路由系统才会解析URL并匹配到对应的控制器方法或匿名函数。
当你在 routes/web.php 中定义路由时，例如：
Route::get('/about', function () { return view('about');});
你是在告诉Laravel，当接收到针对 /about 路径的GET请求时，应该渲染 about 视图。然而，这个匹配过程的前提是请求必须首先到达Laravel的入口文件 public/index.php。
常见问题：URL中的“public”路径段
许多Laravel初学者在本地开发时，可能会遇到类似 http://localhost/ecommerce/public/about 这样的URL访问方式导致404错误。这里的问题症结在于URL中多余的 /public 部分。
当Web服务器（如Apache或Nginx）接收到 http://localhost/ecommerce/public/about 这样的请求时，它会尝试在 ecommerce 目录下寻找一个名为 public 的子目录，然后在这个 public 目录中寻找一个名为 about 的文件或目录。由于Laravel的路由系统是通过 index.php 统一处理的，Web服务器并不会将 /about 视为一个需要由Laravel路由解析的路径，而是将其视为一个物理文件路径。因此，如果 public 目录下没有 about 文件，就会返回404错误。
正确的访问方式应该是让Web服务器的文档根目录直接指向Laravel项目的 public 目录，这样当访问 http://localhost/about 时，请求会直接被 public/index.php 捕获并交由Laravel路由处理。
解决方案一：使用Laravel内置开发服务器
对于本地开发，Laravel提供了一个方便快捷的内置开发服务器。它会自动将文档根目录设置为项目的 public 目录，从而避免手动配置Web服务器的麻烦。
使用方法：在你的Laravel项目根目录下，打开终端并执行以下命令：
php artisan serve
执行成功后，通常会显示类似 Laravel development server started: 的信息。此时，你只需通过 http://127.0.0.1:8000/about （或 http://localhost:8000/about）这样的URL访问你的应用，Laravel的路由系统就能正常工作。
示例：假设 routes/web.php 中定义了如下路由：
// routes/web.phpRoute::get('/', function () { return view('welcome');});Route::get('/about', function () { return view('about');});
启动 php artisan serve 后，访问 http://127.0.0.1:8000/ 会显示 welcome 页面，访问 http://127.0.0.1:8000/about 则会显示 about 页面，一切正常。
解决方案二：配置Web服务器的文档根目录
在生产环境或需要使用Apache/Nginx等专业Web服务器进行本地开发时，你需要手动配置Web服务器的文档根目录（Document Root），使其指向Laravel项目的 public 目录。
配置思路：将Web服务器的虚拟主机（Virtual Host）配置中的 DocumentRoot 指令指向你的Laravel项目路径下的 public 目录。
Apache示例（httpd-vhosts.conf 或站点配置文件）：
ServerName your-laravel-app.test DocumentRoot "/path/to/your/ecommerce/public" AllowOverride All Require all granted ErrorLog "${APACHE_LOG_DIR}/your-laravel-app-error.log" CustomLog "${APACHE_LOG_DIR}/your-laravel-app-access.log" combined
Nginx示例（站点配置文件）：
server { listen 80; server_name your-laravel-app.test; root /path/to/your/ecommerce/public; add_header X-Frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header X-Content-Type-Options "nosniff"; add_header Referrer-Policy "origin-when-cross-origin"; add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"; index index.php index.html index.htm; charset utf-8; location / { try_files $uri $uri/ /index.php?$query_string; } location = /favicon.ico { access_log off; log_not_found off; } location = /robots.txt { access_log off; log_not_found off; } error_page 404 /index.php; location ~ .php$ { fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 根据你的PHP版本和FPM配置修改 fastcgi_index index.php; fastcgi_buffers 16 16k; fastcgi_buffer_size 32k; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; } location ~ /.(?!well-known).* { deny all; }}
完成配置后，你需要重启Web服务器（例如 sudo service apache2 restart 或 sudo service nginx restart），然后通过配置的 ServerName（例如 http://your-laravel-app.test/about）访问应用。
注意事项与最佳实践
避免手动添加 public: 永远不要在浏览器URL中手动输入 /public 来访问Laravel应用。这表明你的服务器配置不正确。本地开发推荐 php artisan serve: 对于简单的本地开发和测试，php artisan serve 是最便捷的选择。生产环境需专业配置: 在生产环境中，务必使用Apache、Nginx等Web服务器，并正确配置其文档根目录，以确保应用的性能、安全性和稳定性。.htaccess 文件: 确保 public 目录下存在 .htaccess 文件（对于Apache），它包含了重写规则，将所有请求都重定向到 index.php。如果你是通过Composer安装Laravel，这个文件应该已经存在。
总结
Laravel项目中的404错误，特别是当路由定义看起来正确但访问URL中包含 /public 时，几乎总是与Web服务器的配置有关，而非Laravel路由代码本身的问题。解决之道在于确保Web服务器的文档根目录正确指向Laravel项目的 public 目录，无论是通过 php artisan serve 还是通过Apache/Nginx的虚拟主机配置。理解这一核心概念，将有助于避免未来在Laravel开发中遇到类似的URL访问问题。
以上就是解决Laravel路由404：理解服务器配置与URL访问的正确姿势的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325078.html
微信扫一扫 
支付宝扫一扫 
