vue项目部署到nginx后一刷新页面就404

概要

在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。

### Vue 项目 Nginx 部署跨域配置解决方案 在将 Vue 项目部署Nginx 时,跨域问题是个常见的挑战。以下是完整的解决方案: #### 1. 确保 Vue 项目的正确打包 在开发阶段,Vue 的 `vue.config.js` 文件中可以通过代理解决跨域问题[^3]。然而,在生产环境中,需要移除或注释掉该文件中的代理配置,以避免与 Nginx 的反向代理冲突[^4]。 ```javascript // vue.config.js module.exports = { publicPath: './', runtimeCompiler: true, // devServer: { // proxy: { // '/api': { // target: 'http://后端服务器IP:8091', // changeOrigin: true, // pathRewrite: { '^/api': '' } // } // } // } }; ``` #### 2. Nginx 配置解决跨域问题 Nginx 的配置是解决跨域问题的核心。以下是个典型的 Nginx 配置示例,确保 Vue Router 和反向代理功能正常工作[^2]。 ```nginx server { listen 80; server_name www.xxx.cn; root /www/wwwroot/www.xxx.cn/dist; # 确保 Vue Router 正常工作 location / { try_files $uri $uri/ /index.html; index index.html; } # 反向代理配置 location /api/ { proxy_pass https://api.xxx.cn/; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } # 解决跨域问题 add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS'; add_header Access-Control-Allow-Headers 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization'; # 处理预检请求 if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS'; add_header Access-Control-Allow-Headers 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization'; return 204; } } ``` #### 3. 注意事项 - **路径匹配**:确保前端请求的 API 路径与 Nginx 的 `location` 匹配规则致[^5]。 - **真实 IP 地址获取**:通过 `proxy_set_header` 设置,后端可以获取真实的客户端 IP 地址。 - **CORS 配置**:使用 `add_header` 指令添加必要的 CORS(跨域资源共享)头部信息。 #### 4. 测试与验证 完成配置后,重启 Nginx 并测试前端是否能够正确访问后端接口。如果仍然出现跨域问题,检查以下内容: - Nginx 配置是否生效。 - 后端服务是否允许来自前端的跨域请求。 ```bash sudo nginx -t # 检查配置文件语法 sudo systemctl restart nginx # 重启 Nginx ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值