解决nginx下vue页面刷新404问题

项目场景:

使用docker打包vue3项目
vue采用history路由模式
路由规则如下:

let routes = [
    { path: '/', redirect: '/base64' }, // Redirect to base64 by default
    { path: '/base64', component: Base64 },
    { path: '/orders', component: Orders },
]

问题描述

通过镜像运行vue3项目,当刷新页面/base64时会出现404页面,只有重新从/进入时才正常。


原因分析:

vue是单页面项目,因此只有一个index.html页面,其余路由的页面并不真实存在,都是通过js实现跳转。
当刷新地址时,nginx无法找到这个具体的页面文件就进入404。
因此解决方式主要有以下几种:

  1. 修改nginx配置文件,添加try_files字段,在进入404之前再一次跳转到index.html
  2. 将404页面也修改为index.html
  3. 更加路由添加或修改location

解决方案:

采用第一种方式比较简单。主要是在dockerfile和nginx.conf文件中做出修改:

  1. 新增nginx.conf文件,将try_files字段添加进去。
server {
    listen 80;
    server_name localhost;

    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}
  1. 用新的nginx.conf替换原有的配置文件
# 使用一个基础镜像,此处使用 Node 14 镜像
FROM node:14 as build

# 设置工作目录
WORKDIR /app

# 拷贝 package.json 和 package-lock.json 并安装依赖
COPY package*.json ./
RUN npm install

# 拷贝项目文件
COPY . .

# 构建 Vue 应用
RUN npm run build

# 构建生产环境镜像
FROM nginx:alpine

# 复制自定义的 Nginx 配置文件到容器
COPY nginx.conf /etc/nginx/conf.d/default.conf

# 将构建好的 Vue 应用拷贝到 Nginx 静态资源目录
COPY --from=build /app/dist /usr/share/nginx/html

# 容器暴露的端口
EXPOSE 80

# 启动 Nginx 服务
CMD ["nginx", "-g", "daemon off;"]

之后就能正常刷新了

  • 1
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值