当在hostinger等共享主机上部署react单页应用（spa）时，用户在刷新页面或直接通过url访问非根路径时可能会遇到404错误。这并非react路由本身的问题，而是由于服务器未能正确处理客户端路由导致的。本文将详细阐述如何通过配置服务器的url重写规则，特别是使用`.htaccess`文件，来确保所有非静态文件请求都被重定向到应用的`index.html`，从而解决这一常见的部署难题。
理解React SPA与服务器路由的冲突
React应用，尤其是使用React Router DOM等库构建的单页应用（SPA），其路由机制是完全在客户端（浏览器）进行的。当用户在应用内部点击链接进行导航时，URL会在不触发页面刷新的情况下改变，React Router会根据URL匹配并渲染相应的组件。
然而，当用户执行以下操作时，问题就出现了：
刷新页面： 用户在访问如/about-us这样的非根路径时，直接刷新了浏览器。直接访问URL： 用户在浏览器中直接输入yourdomain.com/contact-us并回车。打开新标签页： 用户右键点击链接选择在新标签页中打开。
在这些情况下，浏览器会向服务器发送一个全新的请求，请求的URL是完整的路径（例如/about-us）。传统的Web服务器（如Apache或Nginx）在接收到这样的请求时，会尝试在文件系统中查找与该URL路径对应的物理文件或目录。由于React应用的非根路径并没有对应的物理HTML文件（所有路由都由index.html加载后通过JavaScript处理），服务器自然会返回404“未找到”错误。
React Router的配置，如示例中的BrowserRouter和Routes，仅在客户端JavaScript环境生效，无法直接影响服务器如何处理传入的HTTP请求。因此，解决之道在于配置服务器，使其能够正确地将所有指向应用内部路由的请求都重定向到index.html文件。
解决方案：配置服务器URL重写规则
对于大多数共享主机环境，尤其是那些使用Apache服务器的，可以通过在项目的public（或部署后应用的根目录）文件夹中添加一个.htaccess文件来配置URL重写规则。这个文件会指示服务器如何处理传入的请求。
以下是解决此问题的.htaccess配置代码：
RewriteEngine On RewriteBase / RewriteRule ^index.html$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteRule . /index.html [L]
.htaccess代码详解
让我们逐行解析这段代码的作用：
: 这是一个条件块，确保只有在Apache服务器启用了mod_rewrite模块时，内部的重写规则才会生效。这是良好的实践，可以避免在模块未加载时引发服务器错误。RewriteEngine On: 开启URL重写引擎。这是使用任何重写规则的前提。RewriteBase /: 设置重写规则的基础URL路径。在这里，/表示重写规则将应用于网站的根目录。如果你的应用部署在子目录中（例如yourdomain.com/my-app/），则需要将此行修改为RewriteBase /my-app/。RewriteRule ^index.html$ – [L]: 这条规则的含义是：如果请求的URL精确匹配index.html，则不执行任何操作（-表示不进行替换），并立即停止处理后续的重写规则（[L]表示Last，即最后一条规则）。这条规则是为了避免将对index.html本身的请求再次重写到index.html，形成不必要的循环。RewriteCond %{REQUEST_FILENAME} !-f: 这是一个重写条件。它检查请求的文件名（%{REQUEST_FILENAME}）是否不是一个真实存在的文件（!-f）。如果请求的文件是一个实际存在的文件（如style.css、main.js、logo.png等），则该条件不满足，后续的重写规则将不会被执行，服务器会直接返回该文件。RewriteCond %{REQUEST_FILENAME} !-d: 另一个重写条件。它检查请求的文件名是否不是一个真实存在的目录（!-d）。这确保了如果请求的是一个实际存在的目录，服务器会正常处理（例如显示目录索引或默认文件），而不是重定向到index.html。RewriteCond %{REQUEST_FILENAME} !-l: 检查请求的文件名是否不是一个符号链接（!-l）。这通常用于避免重写符号链接，确保它们能被正确解析。RewriteRule . /index.html [L]: 这是核心的重写规则。.：匹配任何字符（除了换行符），意味着这条规则会匹配所有剩余的请求。/index.html：将所有匹配的请求重写到/index.html。[L]：表示这是最后一条规则，停止进一步的重写处理。这条规则的作用是：如果一个请求既不是一个真实存在的文件，也不是一个真实存在的目录，也不是一个符号链接，那么它就会被重定向到index.html。这样，所有的客户端路由请求都会被index.html加载的JavaScript代码处理。
部署与注意事项
文件位置： 将上述.htaccess文件放置在你React项目构建后，包含index.html和所有静态资源的根目录。通常，这会是你的build或dist文件夹在服务器上的对应位置（例如，如果你将build文件夹的内容上传到Hostinger的public_html目录，那么.htaccess就应该放在public_html中）。清除缓存： 在部署.htaccess文件后，建议清除浏览器缓存，并尝试刷新页面或直接访问深层路由，以确认问题是否解决。服务器类型： 本教程主要针对Apache服务器。如果你的主机使用Nginx，则需要配置Nginx的try_files指令来实现类似的功能。例如，在Nginx的server块中：
location / { try_files $uri $uri/ /index.html;}
CDN配置： 如果你使用了CDN来分发静态资源，请确保CDN的配置不会干扰到对index.html的重写规则。通常，CDN只缓存静态文件，动态请求仍然会回源到你的服务器。
总结
解决React SPA在共享主机上刷新或直接访问非根路径时出现的404错误，关键在于正确配置服务器的URL重写规则。通过为Apache服务器添加一个.htaccess文件，并利用RewriteEngine、RewriteCond和RewriteRule指令，我们可以确保所有指向应用内部路由的请求都被无缝地重定向到index.html。这使得客户端路由能够正常工作，从而提供流畅的用户体验。理解服务器如何处理请求与客户端路由之间的交互是成功部署SPA的关键一步。
以上就是解决React SPA在共享主机刷新/新标签页404错误的指南的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1529737.html
微信扫一扫 
支付宝扫一扫 
