概要
在Vue项目部署到Nginx服务器上时,遇到刷新页面显示404的问题,通常是因为Nginx无法正确地处理Vue路由。Vue应用的路由是前端路由,依赖于JavaScript来动态解析URL,当直接访问除根路径外的URL时,Nginx默认会尝试在服务器上找到对应的文件或目录,如果找不到就会返回404错误。
为了解决这个问题,你需要配置Nginx,使得所有请求都重定向到Vue应用的入口文件(通常是index.html),这样无论请求什么URL,Vue的路由都能正确处理。以下是一个基本的Nginx配置示例,用于解决这个问题:
技术细节
以宝塔为例,新建网站后对网站编辑伪静态:
location / {
root /www/wwwroot/vue; # Vue应用打包后的文件存放的目录
try_files $uri $uri/ /index.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。