本文旨在解决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:xampphtdocsecommerce，则进入该目录）。运行以下命令：
php artisan serve
执行此命令后，您会看到类似Laravel development server started: 的输出。
通过显示的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虚拟主机配置示例：
ServerAdmin webmaster@localhost ServerName yourdomain.com # 替换为您的域名或 localhost DocumentRoot "C:/xampp/htdocs/ecommerce/public" # 替换为您的Laravel项目public目录的绝对路径 Options Indexes FollowSymLinks AllowOverride All # 允许使用.htaccess文件 Require all granted ErrorLog "${APACHE_LOG_DIR}/error.log" CustomLog "${APACHE_LOG_DIR}/access.log" combined
配置步骤：
修改DocumentRoot：将其指向您的Laravel项目中的public目录的绝对路径。配置：确保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 IlluminateSupportFacadesRoute;/*|--------------------------------------------------------------------------| Web Routes|--------------------------------------------------------------------------|| Here is where you can register web routes for your application. These| routes are loaded by the RouteServiceProvider within a group which| contains the "web" middleware group. Now create something great!|*/// 根路由，返回欢迎页面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文件内容示例：
About Us Welcome to Our About Page
This is a simple about page in Laravel.
注意事项与总结
文档根目录是关键：无论您使用哪种方式运行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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325082.html
微信扫一扫 
支付宝扫一扫 
