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

问题假设

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

原理探究

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

1. 前端路由：
   • 在前端开发中，SPA（Single 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; 
    }
}
1
2
3
4
5
6
7
8
9
10
11