问题现象:打包后点懒加载路由直接 404
Vite 5 项目本地 npm run dev 一切正常,执行 npm run build 后用 vite preview 或部署到 Nginx,点懒加载路由就报 Failed to fetch dynamically imported module,控制台能看到请求的 JS 路径是 /assets/xxx.js,返回 404。这个问题九成出在 base 配置上,开发模式下 Vite 默认用根路径 / 没问题,但打包后资源的真实路径取决于部署目录。
原因:base 没写或写错
项目如果部署在 https://example.com/admin/ 子目录下,但 vite.config.js 里没写 base,默认值是 /,打包出来的 index.html 引用的就是 /assets/index-xxx.js,浏览器实际请求根目录资源,自然 404。开发模式下 Vite 自己起的服务把所有路径代理到根,所以不会暴露这个问题。
// vite.config.js
import { defineConfig } from 'vite'
export default defineConfig({
// 部署在子目录时必须写 base,末尾要带 /
base: '/admin/',
build: {
outDir: 'dist',
assetsDir: 'assets',
},
})
// 部署位置不固定时用相对路径更稳
// base: './'
改完后本地验证与 Nginx 配置
改完 base 重新 npm run build,用 vite preview --base /admin/ 本地验证懒加载路由能否正常打开。如果用 Nginx,子目录要用 alias 而不是 root,且 alias 末尾要带 /,否则刷新页面会 404。
另一个常见坑:CDN 缓存旧 index.html
如果 base 没问题但还是报错,多半是 CDN 缓存了旧的 index.html,浏览器拿到的 HTML 引用了已不存在的旧 chunk 哈希。给 index.html 加 Cache-Control: no-cache,带哈希的静态资源设长缓存,就能避免新旧版本混用。
动态 import 路径不要写绝对路径
动态 import 的路径如果写成以 / 开头的绝对路径,子目录部署时会指向根目录。推荐用 import.meta.env.BASE_URL 拼接,让路径自动适配 base:
// 推荐写法,自动适配 base 配置
const mod = await import(`${import.meta.env.BASE_URL}views/Dashboard.vue`)
// 不要写绝对路径,子目录下会 404
// const mod = await import('/src/views/Dashboard.vue')
总结:Vite 5 打包后动态 import 报 Failed to fetch dynamically imported module,先查 base 是否与部署目录一致,再确认 CDN 没缓存旧 index.html,最后把动态 import 绝对路径改成 import.meta.env.BASE_URL 写法。
