本文旨在解决 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)：
<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>配置步骤：
- 修改 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:\Windows\System32\drivers\etc\hosts；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 nginx sudo 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 应用程序能够正常解析所有定义的路由。
