本文旨在解决 laravel 初学者在定义新路由（如 `/about`）时遇到的 404 错误。核心问题在于不正确的 url 访问方式或 web 服务器配置。教程将详细介绍两种解决方案：使用 laravel 内置的 `php artisan serve` 命令，以及如何正确配置 apache 或 nginx 服务器的文档根目录，确保所有请求都通过 laravel 的 `public` 目录处理，从而避免路由识别失败。
在使用 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 提供的内置开发服务器。它会自动处理请求重写，将所有请求正确地指向 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 服务器，非常适合快速开发和测试。
如果你需要使用 Apache、Nginx 等 Web 服务器进行本地开发或部署到生产环境，则需要正确配置它们的文档根目录（Document Root）或根目录（root），使其直接指向 Laravel 项目的 public 目录。这样，Web 服务器就会将所有请求的起始点视为 public 目录，并利用 public 目录中的 .htaccess (Apache) 或 Nginx 配置规则将请求重写到 public/index.php。
对于 Apache 服务器，你需要创建一个虚拟主机（Virtual Host）配置，并将 DocumentRoot 指向 Laravel 项目的 public 目录。
示例 Apache 虚拟主机配置 (your_project.conf)：
<VirtualHost *:80>
ServerName your_project.test # 自定义域名，需要修改 hosts 文件
DocumentRoot "/path/to/your_laravel_project/public"
<Directory "/path/to/your_laravel_project/public">
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/your_project_error.log
CustomLog ${APACHE_LOG_DIR}/your_project_access.log combined
</VirtualHost>配置步骤：
127.0.0.1 your_project.test
现在，你可以通过 http://your_project.test/about 访问你的路由。
对于 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;
}
}配置步骤：
sudo ln -s /etc/nginx/sites-available/your_project.conf /etc/nginx/sites-enabled/your_project.conf
sudo systemctl restart nginx sudo systemctl restart php8.1-fpm # 根据你的 PHP-FPM 版本修改
现在，你可以通过 http://your_project.test/about 访问你的路由。
Laravel 路由 404 错误通常是由于 Web 服务器未能正确将所有请求重写到 public/index.php 引起的。解决此问题的关键在于确保 Web 服务器的文档根目录（或根目录）指向 Laravel 项目的 public 目录。
理解 Laravel 的前端控制器模式和 public 目录的重要性，是避免这类路由问题的基础。通过正确的服务器配置，你可以确保 Laravel 应用程序能够正常解析所有定义的路由。
以上就是解决 Laravel 路由 404 错误：理解 public 目录与服务器配置的详细内容，更多请关注php中文网其它相关文章！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
387
收藏
