必须前后端协同配置:前端用createWebHistory并设正确base路径,构建时指定静态资源根路径,服务端需fallback所有请求至index.html,否则子路由刷新会404。

在 Vite + Vue3 单页应用中启用 history 路由,需前后端协同配置:前端明确使用 createWebHistory 并设置正确的基础路径,构建时指定静态资源根路径,部署后服务端必须 fallback 所有请求到 index.html,否则直接访问子路由会 404。
前端路由初始化用 createWebHistory
在 src/router/index.ts(或 .js)中,确保调用 createRouter 时传入 createWebHistory:
- 导入方式:
import { createRouter, createWebHistory } from 'vue-router' - history 配置项应为:
history: createWebHistory(import.meta.env.BASE_URL)或createWebHistory('/') -
BASE_URL通常来自.env文件,如VITE_PUBLIC_PATH=/myapp/,用于子目录部署
Vite 构建配置 base 路径
vite.config.ts 中的 base 参数决定静态资源引用前缀,必须与路由基础路径一致:
- 若部署在域名根目录(
https://example.com/),设base: '/' - 若部署在子路径(
https://example.com/admin/),设base: '/admin/' - 该值会自动注入
import.meta.env.BASE_URL,供路由和资源加载使用
服务端必须配置 fallback
history 模式下,用户刷新 /user/123 时,请求会发到服务端。服务器不能返回 404,而应始终返回 index.html,交由前端路由接管:
- Nginx 示例:
location / { try_files $uri $uri/ /index.html; } - Apache 示例:在
.htaccess中启用mod_rewrite,重写所有非资源请求到index.html - 开发阶段无需手动配——Vite Dev Server 默认已内置 fallback
环境变量统一管理路径
推荐通过 .env.production 统一控制生产环境路径:
- 写入
VITE_PUBLIC_PATH=/(根部署)或VITE_PUBLIC_PATH=/app/(子目录) - 在
vite.config.ts中读取:base: process.env.VITE_PUBLIC_PATH - 在
router中复用:createWebHistory(import.meta.env.VITE_PUBLIC_PATH)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











