1. 首页
  2. 软件开发
  3. 前端
  4. vue项目 部署到nginx 上刷新页面显示404

vue项目 部署到nginx 上刷新页面显示404

  • 发布于 2024-10-08
  • 13 次阅读

在Vue项目部署到Nginx服务器上时,遇到刷新页面显示404的问题,通常是因为Nginx无法正确地处理Vue路由(尤其是单页面应用(SPA)中的前端路由)。Vue应用的路由是前端路由,依赖于JavaScript来动态解析URL,当直接访问除根路径外的URL时,Nginx默认会尝试在服务器上找到对应的文件或目录,如果找不到就会返回404错误。

为了解决这个问题,你需要配置Nginx,使得所有请求都重定向到Vue应用的入口文件(通常是index.html),这样无论请求什么URL,Vue的路由都能正确处理。以下是一个基本的Nginx配置示例,用于解决这个问题:

server {  
    listen       80;  
    server_name  yourdomain.com; # 替换为你的域名或IP  

    location / {  
        root   /usr/share/nginx/html; # Vue应用打包后的文件存放的目录  
        try_files $uri $uri/ /index.html; # 尝试找到请求的文件或目录,如果找不到,则返回index.html  
    }  

    # 其他配置...  

    error_page   500 502 503 504  /50x.html;  
    location = /50x.html {  
        root   /usr/share/nginx/html;  
    }  
}

这里的关键是try_files指令,它按照列出的顺序检查文件是否存在,如果文件或目录不存在,则最后会返回/index.html。由于Vue应用是SPA,所有路由都应该在前端处理,因此返回index.html是合适的。

确保你的Vue应用已经通过npm run build(或类似的命令)构建完成,并且所有的构建文件(包括index.html)都已经被放置在Nginx的root指令指定的目录中。

如果你正在使用Vue CLI 3或更高版本,并且使用vue-cli-service build来构建你的项目,它默认会生成一个dist/目录,你需要确保Nginx的root指令指向这个目录(或者将其内容复制到Nginx的默认目录)。

最后,不要忘记重启Nginx服务以使配置生效。你可以使用sudo systemctl restart nginx(对于使用systemd的系统)或其他相应的命令来重启Nginx。

原文链接: https://blog.csdn.net/qq_30517167/article/details/140692087