本文旨在解决 laravel 初学者在定义新路由（如 `/about`）时遇到的 404 错误。核心问题在于不正确的 url 访问方式或 web 服务器配置。教程将详细介绍两种解决方案：使用 laravel 内置的 `php artisan serve` 命令，以及如何正确配置 apache 或 nginx 服务器的文档根目录，确保所有请求都通过 laravel 的 `public` 目录处理，从而避免路由识别失败。
Laravel 路由 404 错误解析
在使用 Laravel 开发项目时，初学者常会遇到定义了新路由（例如 Route::get(‘/about’, …)）但访问时却出现“404 Not Found”错误的情况。这通常发生在尝试通过类似 http://localhost/your_project/public/about 的 URL 访问时。尽管 Route::get(‘/’, function () { return view(‘welcome’); }); 可以通过 http://localhost/your_project/public/ 正常工作，但添加其他路由后却无法识别。
问题的根源在于 Laravel 应用程序的入口点。Laravel 框架遵循前端控制器（Front Controller）模式，所有的 HTTP 请求都应该通过项目根目录下的 public/index.php 文件进行处理。这意味着，无论是访问根路径 / 还是其他自定义路由 /about，其请求都必须被 Web 服务器重写并指向 public/index.php。
当你在 URL 中显式包含 /public/ 时，例如 http://localhost/your_project/public/about，Web 服务器会尝试在 your_project/public/ 目录下查找名为 about 的文件或目录，而不是将请求传递给 Laravel 的路由系统处理。由于 about 并非物理文件，且请求未被 index.php 引导，因此会返回 404 错误。
解决方案一：使用 Laravel 内置开发服务器
对于本地开发环境，最简单和推荐的解决方案是使用 Laravel 提供的内置开发服务器。它会自动处理请求重写，将所有请求正确地指向 public/index.php。
启动开发服务器在你的 Laravel 项目根目录下打开终端或命令行工具，执行以下命令：
php artisan serve
执行成功后，你将看到类似如下的输出：
Laravel development server started: http://127.0.0.1:8000
访问应用程序现在，你可以通过 http://127.0.0.1:8000 或 http://localhost:8000 访问你的 Laravel 应用程序。对于 about 路由，访问 URL 应为：
http://127.0.0.1:8000/about
或者，如果你想在其他端口启动服务器，可以使用 –port 选项：
php artisan serve --port=8080
此时访问 URL 为 http://127.0.0.1:8080/about。
这种方法无需额外配置 Web 服务器，非常适合快速开发和测试。
解决方案二：配置 Web 服务器的文档根目录
如果你需要使用 Apache、Nginx 等 Web 服务器进行本地开发或部署到生产环境，则需要正确配置它们的文档根目录（Document Root）或根目录（root），使其直接指向 Laravel 项目的 public 目录。这样，Web 服务器就会将所有请求的起始点视为 public 目录，并利用 public 目录中的 .htaccess (Apache) 或 Nginx 配置规则将请求重写到 public/index.php。
1. Apache 服务器配置
对于 Apache 服务器，你需要创建一个虚拟主机（Virtual Host）配置，并将 DocumentRoot 指向 Laravel 项目的 public 目录。
示例 Apache 虚拟主机配置 (your_project.conf)：
ServerName your_project.test # 自定义域名，需要修改 hosts 文件 DocumentRoot "/path/to/your_laravel_project/public" AllowOverride All Require all granted ErrorLog ${APACHE_LOG_DIR}/your_project_error.log CustomLog ${APACHE_LOG_DIR}/your_project_access.log combined
配置步骤：
修改 httpd-vhosts.conf (或创建新文件)：通常位于 conf/extra/httpd-vhosts.conf。将上述配置添加到其中，并替换 /path/to/your_laravel_project 为你实际的 Laravel 项目路径。启用 mod_rewrite 模块：确保 Apache 的 mod_rewrite 模块已启用。在 httpd.conf 文件中查找并取消注释 LoadModule rewrite_module modules/mod_rewrite.so。修改 hosts 文件：如果你使用了 ServerName your_project.test 这样的自定义域名，你需要修改操作系统的 hosts 文件（Windows: C:WindowsSystem32driversetchosts；macOS/Linux: /etc/hosts），添加一行：
127.0.0.1 your_project.test
重启 Apache 服务器：保存所有更改后，重启 Apache 服务器。
现在，你可以通过 http://your_project.test/about 访问你的路由。
2. Nginx 服务器配置
对于 Nginx 服务器，你需要配置一个 server 块，并将 root 指令指向 Laravel 项目的 public 目录。
示例 Nginx 服务器配置 (your_project.conf)：
server { listen 80; server_name your_project.test; # 自定义域名，需要修改 hosts 文件 root /path/to/your_laravel_project/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"; 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_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; } location ~ /.(?!well-known).* { deny all; }}
配置步骤：
创建 Nginx 配置文件：通常在 /etc/nginx/sites-available/ 目录下创建一个新文件，例如 your_project.conf。将上述配置添加到其中，并替换 /path/to/your_laravel_project 为你实际的 Laravel 项目路径，同时根据你的 PHP-FPM 版本修改 fastcgi_pass。创建符号链接：在 /etc/nginx/sites-enabled/ 目录下创建指向 sites-available 中配置文件的符号链接：
sudo ln -s /etc/nginx/sites-available/your_project.conf /etc/nginx/sites-enabled/your_project.conf
修改 hosts 文件：同 Apache 配置，如果你使用了 ServerName your_project.test，需要修改 hosts 文件。重启 Nginx 和 PHP-FPM：保存所有更改后，重启 Nginx 和 PHP-FPM 服务：
sudo systemctl restart nginxsudo systemctl restart php8.1-fpm # 根据你的 PHP-FPM 版本修改
现在，你可以通过 http://your_project.test/about 访问你的路由。
总结
Laravel 路由 404 错误通常是由于 Web 服务器未能正确将所有请求重写到 public/index.php 引起的。解决此问题的关键在于确保 Web 服务器的文档根目录（或根目录）指向 Laravel 项目的 public 目录。
对于本地开发，最便捷的方式是使用 php artisan serve 命令，它会自动处理所有必要的配置。对于生产环境或更复杂的本地设置，需要手动配置 Apache 或 Nginx 服务器，将 DocumentRoot 或 root 指向 Laravel 项目的 public 目录，并确保相应的重写规则（如 Apache 的 mod_rewrite 或 Nginx 的 try_files）正确生效。
理解 Laravel 的前端控制器模式和 public 目录的重要性，是避免这类路由问题的基础。通过正确的服务器配置，你可以确保 Laravel 应用程序能够正常解析所有定义的路由。
以上就是解决 Laravel 路由 404 错误：理解 public 目录与服务器配置的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325080.html
微信扫一扫 
支付宝扫一扫 
