Vue项目部署Nginx后页面刷新404问题的解决方案

Vue项目部署Nginx后页面刷新404问题的解决方案

引用

CSDN

1.

https://blog.csdn.net/m0_74824894/article/details/144344141

在使用Vue.js开发的单页应用（SPA）中，当采用history模式的路由配置时，直接刷新页面或通过非根路径访问页面可能会遇到404错误。本文将详细介绍如何通过修改Nginx配置来解决这一问题，包括使用宝塔面板的简易解决方案和直接修改nginx.conf文件的通用方法。

如果你的项目使用了 Vue，并使用了路由且路由配置为 history 模式，就会出现这种情况。当你使用 Nginx 部署前端项目时，发现页面刷新或不用根目录访问页面时，出现404页面。

宝塔面板

解决方法：修改 Nginx 配置，我这边用的宝塔部署，所以改配置也是相对简单的，只需要加一行代码就行。具体步骤如下

1. 部署网站后，在宝塔网站中点击设置
   
2. 在设置中的配置文件，server中添加相应代码即可，

try_files $uri $uri/ /index.html; #解决刷新页面变成404问题的代码

3. 保存立即生效，快去试试吧。

修改配置文件

如果不是宝塔的话，可以找一下你项目对应的 nginx.conf 这个文件，对这个文件进行修改就可以了。

server
{
    listen 8081;
    server_name 地址;
    index index.php index.html index.htm default.php default.htm default.html;
    root 目录;
# gzip on;
#     gzip_min_length 1k;
#     gzip_comp_level 9;
#     gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;
#     gzip_vary on;
#     gzip_disable "MSIE [1-6].";
    
    try_files $uri $uri/ /index.html;    #解决刷新页面变成404问题的代码
    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    #SSL-END
    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    #error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END
    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-80.conf;
    #PHP-INFO-END
    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/lin-blog.com.conf;
    #REWRITE-END
    #禁止访问的文件或目录
    location ~ ^/(.user.ini|.htaccess|.git|.env|.svn|.project|LICENSE|README.md)
    {
        return 404;
    }
    #一键申请SSL证书验证目录相关设置
    location ~ .well-known{
        allow all;
    }
    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/.well-known/.*.(php|jsp|py|js|css|lua|ts|go|zip|tar.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }
    location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
        error_log /dev/null;
        access_log /dev/null;
    }
    location ~ .*.(js|css)?$
    {
        expires      12h;
        error_log /dev/null;
        access_log /dev/null;
    }
    access_log  /www/wwwlogs/xxx.log;
    error_log  /www/wwwlogs/xxx.com.error.log;
}

主要就是添加一行代码，在 server 中就可以了。

try_files $uri $uri/ /index.html; #解决刷新页面变成404问题的代码