本文旨在解决laravel项目中常见的非根路径路由（如`/about`）返回404错误的问题。核心原因在于url中不当包含了`public`目录，导致laravel路由系统无法正确解析请求。文章将详细阐述通过使用`php artisan serve`开发服务器或正确配置web服务器（如apache/nginx）的文档根目录来解决此问题，确保所有路由均可正常访问。
Laravel路由404问题分析
在使用Laravel框架进行开发时，初学者常会遇到一个令人困惑的问题：当定义了非根路径的路由（例如Route::get('/about', ...)），并通过浏览器访问http://localhost/your_project/public/about时，却收到“404 Not Found”错误。然而，如果将相同的视图文件（如about.blade.php）绑定到根路由Route::get('/', function () { return view('about'); });，并通过http://localhost/your_project/public/访问时，页面却能正常显示。这表明视图文件和路由定义本身并没有问题，问题的症结在于URL的解析方式。
问题的根本原因在于Laravel框架的入口点。Laravel应用程序的所有HTTP请求都应该通过项目的public/index.php文件进行引导。当您在浏览器中访问http://localhost/your_project/public/时，Web服务器会将请求指向public目录下的index.php，Laravel路由系统能够正确地处理根路径。然而，当您试图访问http://localhost/your_project/public/about时，Web服务器会尝试在public目录下寻找一个名为about的文件或目录，而不是将/about作为参数传递给index.php进行路由处理。这种行为导致了404错误。
解决方案
解决此问题的核心思想是确保Web服务器将Laravel项目的public目录设置为文档根目录（document Root），从而使所有请求都默认通过public/index.php进行处理。
方案一：使用Laravel内置开发服务器 php artisan serve (推荐用于开发环境)
Laravel提供了一个轻量级的内置开发服务器，它会自动将项目的public目录作为文档根目录，从而简化了本地开发环境的配置。
打开终端或命令行工具。切换到您的Laravel项目根目录（例如，如果您的项目在C:\xampp\htdocs\ecommerce，则进入该目录）。运行以下命令：php artisan serve登录后复制
执行此命令后，您会看到类似Laravel development server started: <http://127.0.0.1:8000>的输出。
通过显示的URL访问您的应用。现在，您可以通过http://127.0.0.1:8000/访问根路由，通过http://127.0.0.1:8000/about访问about路由，而无需在URL中包含public。优点：
配置简单，无需额外Web服务器设置。自动处理文档根目录问题。适用于快速原型开发和本地测试。缺点：
不适用于生产环境。性能不如专业的Web服务器（如Apache或Nginx）。方案二：配置Web服务器 (适用于生产环境或自定义本地环境)
如果您不使用php artisan serve，或者需要将Laravel项目部署到生产环境，则必须正确配置您的Web服务器（如Apache或Nginx），将文档根目录指向Laravel项目的public文件夹。
1. Apache 服务器配置
对于Apache，您通常需要编辑虚拟主机配置文件（例如，位于conf/extra/httpd-vhosts.conf或/etc/apache2/sites-available/your-site.conf），或者直接修改httpd.conf。
以下是一个Apache虚拟主机配置示例：
AI建筑知识问答 用人工智能ChatGPT帮你解答所有建筑问题
22 查看详情 
<VirtualHost *:80> ServerAdmin webmaster@localhost ServerName yourdomain.com # 替换为您的域名或 localhost documentRoot "C:/xampp/htdocs/ecommerce/public" # 替换为您的Laravel项目public目录的绝对路径 <Directory "C:/xampp/htdocs/ecommerce/public"> Options Indexes FollowSymlinks AllowOverride All # 允许使用.htaccess文件 Require all granted </Directory> ErrorLog "${APACHE_LOG_DIR}/error.log" CustomLog "${APACHE_LOG_DIR}/access.log" combined</VirtualHost>登录后复制配置步骤：
修改documentRoot：将其指向您的Laravel项目中的public目录的绝对路径。配置<Directory>：确保AllowOverride All被启用，这允许Apache读取和应用public目录下的.htaccess文件，该文件包含了Laravel路由重写规则。启用mod_rewrite模块：确保Apache的mod_rewrite模块已启用（通常在httpd.conf中通过LoadModule rewrite_module modules/mod_rewrite.so）。重启Apache服务器。配置完成后，您可以通过http://yourdomain.com/about或http://localhost/about（如果ServerName设置为localhost）来访问您的路由。
2. Nginx 服务器配置
对于Nginx，您需要编辑服务器块配置文件（通常位于/etc/nginx/sites-available/your-site.conf）。
以下是一个Nginx服务器块配置示例：
server { listen 80; server_name yourdomain.com localhost; # 替换为您的域名或 localhost root /var/www/ecommerce/public; # 替换为您的Laravel项目public目录的绝对路径 add_header X-frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header X-Content-Type-Options "nosniff"; index index.php; 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 socket路径或TCP地址 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; }}登录后复制配置步骤：
修改root指令：将其指向您的Laravel项目中的public目录的绝对路径。配置location /块：使用try_files $uri $uri/ /index.php?$query_string;确保所有未找到的文件或目录请求都被重写到index.php，由Laravel进行处理。配置location ~ \.php$块：确保PHP-FPM配置正确，并指向正确的socket文件或TCP地址。重启Nginx服务器和PHP-FPM服务。配置完成后，您可以通过http://yourdomain.com/about或http://localhost/about来访问您的路由。
示例代码
以下是routes/web.php中路由定义的示例：
<?phpuse Illuminate\Support\Facades\Route;// 根路由，返回欢迎页面Route::get('/', function () { return view('welcome');});// about页面路由Route::get('/about', function () { return view('about'); // 返回 resources/views/about.blade.php});// 也可以直接返回字符串，验证路由是否工作Route::get('/test', function () { return 'Hello from the test page!';});登录后复制resources/views/about.blade.php文件内容示例：
<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>about Us</title></head><body> <h1>Welcome to Our about Page</h1> <p>This is a simple about page in Laravel.</p></body></html>登录后复制
注意事项与总结
文档根目录是关键：无论您使用哪种方式运行Laravel，确保Web服务器的文档根目录指向项目的public文件夹是解决路由问题的核心。开发环境与生产环境：php artisan serve非常适合开发，但生产环境应使用Apache或Nginx等专业Web服务器。清除路由缓存：在某些情况下，即使配置正确，路由缓存也可能导致问题。可以尝试运行php artisan route:clear和php artisan config:clear来清除缓存。.htaccess文件：对于Apache，public目录下的.htaccess文件至关重要，它包含了将所有请求重写到index.php的规则。确保该文件存在且内容正确。通过理解Laravel的入口点机制以及Web服务器的文档根目录配置，您可以有效地解决Laravel项目中常见的非根路径路由404问题，确保您的应用程序能够正常运行。
以上就是解决Laravel非根路径路由404问题：深入理解URL结构与服务器配置的详细内容，更多请关注php中文网其它相关文章！
