使用nginx方向代理部署Vue项目刷新页面404的问题解决-CSDN博客

问题假设

• 部署出现的问题为由于项目中使用的vue router 项目直接使用node环境部署项目在同一个路由如: 192.168.1.30:/home刷新浏览器正常 nginx部署刷新不出现404 /nginx not found 如何解决
• 以下是我的想法似乎是nginx代理使其直接访问文件而没有使项目的路由生效从而正确加载资源

原理探究

这种Nginx配置背后的原理涉及到前端路由和服务器的工作方式。

1. 前端路由
   • 在前端开发中SPASingle Page Application应用程序使用前端路由来实现页面切换和导航。
   • 前端路由是在浏览器中处理的而不是通过传统的页面请求和刷新。
   • SPA应用通常使用JavaScript库或框架如Vue Router、React Router等来管理前端路由。
   • 这些路由库允许应用程序的不同路径映射到不同的组件或页面。
2. 服务器处理
   • 当浏览器发出请求时Web服务器如Nginx会根据请求的路径来定位并返回相应的资源或页面。
   • 在传统的Web应用中服务器会查找匹配的HTML文件并将其发送给浏览器。然而在SPA中服务器通常只返回应用的入口点例如index.html而所有的路由和页面切换是在浏览器中通过前端路由进行管理的。
3. 问题的根本
   • 当使用前端路由时如果你直接访问特定路径例如 http://example.com/home浏览器中的前端路由会正确解析这个路径并显示对应的页面因为JavaScript路由库知道如何处理它。然而如果你刷新页面或者直接在地址栏中输入URL服务器会尝试查找与该路径匹配的实际文件但在SPA中通常没有与每个路由路径相对应的独立HTML文件因此服务器会返回404错误。
4. 解决方案
   • 为了解决这个问题需要配置Nginx以便对所有请求都返回应用的入口点通常是 index.html。这样不管浏览器中的路径是什么服务器都会返回相同的index.html。一旦浏览器加载了这个HTML文件前端路由库会根据URL来呈现正确的页面内容。

• 所以Nginx配置的关键点是将所有请求都传递给Vue应用的 index.html这个HTML文件包含了前端路由的逻辑它会根据URL来呈现不同的内容从而确保前端路由能够正确处理所有的路由请求无论是直接访问还是刷新页面。
• 它解决了前端路由在SPA中的刷新问题让SPA应用可以在不同的路由之间无缝导航。

问题解决

• 当使用Vue Router时前端路由是在客户端进行处理的而Nginx作为反向代理服务器默认只处理静态文件的请求。这就是为什么直接访问 xxx.xxx.xxx.xxx:/home 时正常工作但刷新页面时会出现404错误的原因。
• 使用通配符来配置Nginx以使其将所有路由请求都指向Vue应用的 index.html确保所有的路由请求都交给Vue Router处理。

server {
    listen       80;
    server_name  demo;
    
    location / {
        root   /usr/carehome_vue;
        index  index.html index.htm;
        # 配置让Vue Router处理路由
        try_files $uri $uri/ /index.html; 
    }
}