解决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;
    }
}

2. 用新的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;"]

之后就能正常刷新了