项目场景:
使用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。
因此解决方式主要有以下几种:
- 修改nginx配置文件,添加
try_files
字段,在进入404之前再一次跳转到index.html - 将404页面也修改为
index.html
- 更加路由添加或修改
location
解决方案:
采用第一种方式比较简单。主要是在dockerfile和nginx.conf文件中做出修改:
- 新增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;
}
}
- 用新的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;"]
之后就能正常刷新了