本教程详细阐述了Laravel应用部署至000webhost等共享主机后，链接无法正常工作并返回404错误的问题。核心解决方案是通过在public_html目录下配置.htaccess文件，正确设置Apache的URL重写规则，确保所有请求都通过Laravel的入口文件index.php处理，从而恢复路由功能，使应用在生产环境正常运行。
引言：Laravel应用在共享主机上的链接问题
在开发Laravel应用时，通常在本地开发环境中，路由和链接都能正常工作。然而，当将应用部署到共享主机平台（如000webhost）时，可能会遇到页面链接失效，访问任何非根路径都返回“Page Not Found – Error 404”的问题。这通常不是代码逻辑错误，而是服务器环境配置与Laravel的URL重写机制不兼容所致。
Laravel框架利用URL重写（Pretty URLs）来实现简洁、友好的路由结构，例如yourdomain.com/posts/1而非yourdomain.com/index.php/posts/1。在Apache服务器上，这通常依赖于mod_rewrite模块和.htaccess文件来将所有请求重定向到应用的入口文件public/index.php。共享主机环境可能没有正确配置此重写规则，或者默认规则与Laravel的需求不符，从而导致除根路径外的所有链接都无法解析。
核心解决方案：配置.htaccess文件
解决此问题的关键在于在应用的根目录（通常是Web服务器指向的public_html目录）下放置一个正确的.htaccess文件，以指导Apache服务器如何处理传入的请求。以下是针对Laravel应用在共享主机上解决404问题的标准.htaccess配置：
Options -MultiViewsRewriteEngine On# 重定向尾部斜杠，如果不是目录RewriteCond %{REQUEST_FILENAME} !-dRewriteRule ^(.*)/$ /$1 [L,R=301]# 处理前端控制器RewriteCond %{REQUEST_FILENAME} !-dRewriteCond %{REQUEST_FILENAME} !-fRewriteRule ^ index.php [L]# 处理授权头部（Authorization Header）RewriteCond %{HTTP:Authorization} .RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
深入理解.htaccess配置
上述.htaccess文件包含了几个关键指令，它们共同确保Laravel应用的路由功能正常：
:
这是一个条件判断，确保只有当Apache的mod_rewrite模块被加载时，其内部的指令才会被执行。这是URL重写功能的核心模块，如果服务器未启用此模块，则重写规则将不会生效。
和 Options -MultiViews:
mod_negotiation是Apache的一个模块，用于内容协商（Content Negotiation），即服务器根据客户端的请求（如语言、编码、媒体类型）提供最适合的版本。Options -MultiViews指令禁用了MultiViews功能。在某些情况下，MultiViews可能会与Laravel的路由机制冲突，因为它可能尝试为请求的URL自动查找匹配的文件，从而绕过Laravel的index.php入口。禁用它可以确保所有请求都按预期通过重写规则处理。
RewriteEngine On:
此指令是启用Apache重写引擎的关键。没有它，所有RewriteRule和RewriteCond指令都不会起作用。
*重定向尾部斜杠 (RewriteCond %{REQUEST_FILENAME} !-d 和 `RewriteRule ^(.)/$ /$1 [L,R=301]`)**:
RewriteCond %{REQUEST_FILENAME} !-d：这是一个条件，检查请求的文件名是否不是一个实际存在的目录。RewriteRule ^(.*)/$ /$1 [L,R=301]：如果请求的URL以斜杠结尾且不是一个目录，此规则会将其重定向到不带尾部斜杠的URL。[L]表示这是最后一条规则（Last），[R=301]表示执行一个永久重定向（Moved Permanently）。这有助于SEO和避免重复内容。
处理前端控制器 (RewriteCond %{REQUEST_FILENAME} !-d、RewriteCond %{REQUEST_FILENAME} !-f 和 RewriteRule ^ index.php [L]):
这组规则是Laravel应用正常运行的核心。RewriteCond %{REQUEST_FILENAME} !-d：检查请求的文件名是否不是一个实际存在的目录。RewriteCond %{REQUEST_FILENAME} !-f：检查请求的文件名是否不是一个实际存在的文件。RewriteRule ^ index.php [L]：如果请求的URL既不是一个真实存在的目录，也不是一个真实存在的文件，那么此规则将所有请求重写到index.php。^匹配任何请求的开始，意味着所有请求都会被捕获。[L]表示这是最后一条规则。这意味着所有非静态文件或目录的请求都将由Laravel的index.php处理，从而启用Laravel的路由系统。
*处理授权头部 (RewriteCond %{HTTP:Authorization} . 和 `RewriteRule . – [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]`)**:
RewriteCond %{HTTP:Authorization} .：检查HTTP请求头中是否存在Authorization字段。RewriteRule .* – [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]：如果存在Authorization头，此规则会将其内容设置到一个名为HTTP_AUTHORIZATION的环境变量中。这对于处理API请求中的认证令牌（如Bearer Token）至关重要，因为某些Apache配置可能会默认剥离Authorization头。
部署步骤与注意事项
文件放置位置: 将上述.htaccess文件放置在你的Laravel应用部署的Web根目录，通常是public_html文件夹。确保文件名为.htaccess（注意开头的点）。
服务器环境要求:
Apache服务器: 此解决方案专为Apache Web服务器设计。如果你的共享主机使用Nginx，则需要配置Nginx的location块来实现类似的功能。mod_rewrite模块: 确保你的共享主机启用了Apache的mod_rewrite模块。如果未启用，你需要联系主机提供商请求启用，或者在cPanel等面板中查找相关选项。
Laravel配置:
APP_URL: 确保你的Laravel .env文件中的APP_URL变量设置为你的实际域名，例如APP_URL=https://maherblog2021.000webhostapp.com。这有助于Laravel生成正确的绝对URL。缓存清除: 部署后，建议清除Laravel的配置和路由缓存，以防旧的缓存导致问题：
php artisan config:clearphp artisan route:clearphp artisan view:clear
如果你没有SSH访问权限，可能需要通过Web界面或FTP删除bootstrap/cache目录下的相关文件。
文件权限: 确保.htaccess文件和Laravel项目目录的文件权限设置正确。通常，文件权限设置为644，目录权限设置为755。
总结
通过在public_html目录下正确配置.htaccess文件，可以有效地解决Laravel应用在共享主机上因URL重写规则缺失或错误导致的404问题。这个.htaccess配置确保了所有非静态文件或目录的请求都能被Laravel的index.php前端控制器正确处理，从而使应用的路由系统正常工作。在部署过程中，务必确认服务器环境（特别是Apache和mod_rewrite）符合要求，并检查Laravel自身的APP_URL配置和缓存状态，以确保应用顺利上线运行。
以上就是解决Laravel应用在共享主机上链接失效的404问题：基于.htaccess的部署指南的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1286505.html
微信扫一扫 
支付宝扫一扫 
