# =============================================================================
|
# 合并部署环境(前端打进 jar,与后端同源)
|
#
|
# 用途: pnpm build:merged
|
#
|
# ────────────────────────────────────────────────────────────────────────────
|
# 【为什么 VITE_BASE_URL 必须留空,且必须配 <base href="/">】
|
#
|
# 前端 API 基地址来自 src/config/axios/config.ts:10:
|
# base_url = VITE_BASE_URL + VITE_API_URL
|
#
|
# axios 1.x 内部逻辑(node_modules/axios/lib/core/buildFullPath.js:18):
|
# 若 requestedURL 不是绝对URL 且 baseURL 非空 → combineURLs(baseURL, requestedURL)
|
# 而 combineURLs(helpers/combineURLs.js:13)会:
|
# baseURL.replace(/\/?\/$/, '') + '/' + requestedURL.replace(/^\/+/, '')
|
# 即:**剥离 baseURL 末尾的斜杠**。
|
#
|
# 实测各组合(假设请求 /system/user/page):
|
#
|
# A) VITE_BASE_URL='/' VITE_API_URL='/admin-api'
|
# → baseURL = '/admin-api/' → combineURLs 剥成 '/admin-api'
|
# → 最终 '/admin-api/system/user/page' ✅
|
#
|
# B) VITE_BASE_URL='' VITE_API_URL='/admin-api'
|
# → baseURL = '/admin-api' → 最终 '/admin-api/system/user/page' ✅
|
#
|
# 但两者在**深层路由**下的表现不同(history 模式下 URL 形如 /ecg/queue):
|
# - 若最终地址是「绝对路径」/admin-api/... → 浏览器从域名根解析 ✅
|
# - 若最终地址是「相对路径」admin-api/... → 会拼到当前路径后
|
# 变成 /ecg/admin-api/... ❌
|
#
|
# 方案 B 在 A 之外多一个前提:必须让页面里的相对地址统一从根解析,
|
# 因此需要在 index.html 加 <base href="/">。
|
# 本项目采用方案 B + <base href="/">(改动最小、语义最清晰)。
|
#
|
# 另外注意:前端用 createWebHistory()(src/router/index.ts:8),
|
# 属 HTML5 history 模式,F5 刷新深层路由必须由后端兜底
|
# (见 SpaForwardController.java),否则刷新即 404。
|
# ────────────────────────────────────────────────────────────────────────────
|
# =============================================================================
|
NODE_ENV=production
|
|
VITE_DEV=false
|
|
# 【关键】留空:base_url 变成 /admin-api(见 src/config/axios/config.ts:10)
|
# 留空而非 '/',避免 axios combineURLs 剥离斜杠带来的歧义
|
VITE_BASE_URL=''
|
|
# 文件上传类型:server - 后端上传, client - 前端直连上传,仅支持 S3 服务
|
VITE_UPLOAD_TYPE=server
|
# 上传地址用【根绝对路径】,保证在任何深度的路由页面下都解析正确
|
# (该变量被 useUpload.ts / Editor.vue 等直接使用,不走 axios baseURL)
|
VITE_UPLOAD_URL='/admin-api/infra/file/upload'
|
|
# 接口地址
|
VITE_API_URL=/admin-api
|
|
# 是否删除debugger
|
VITE_DROP_DEBUGGER=true
|
|
# 是否删除console.log
|
VITE_DROP_CONSOLE=true
|
|
# 是否sourcemap
|
VITE_SOURCEMAP=false
|
|
# 打包路径(必须是 / :index.html 使用了 /favicon.ico、/logo.gif 等根绝对路径)
|
VITE_BASE_PATH=/
|
|
# 输出路径:独立目录,避免与现有 dist-prod / dist-test 混淆
|
VITE_OUT_DIR=dist-merged
|
|
# 关闭 .gz 压缩产物。
|
# 原因:合并部署时前端由 jar 提供,Spring Boot 不会自动服务 .gz 文件,
|
# 它们只会白占 jar 体积(实测 dist-merged 曾产生 59 个 .gz)。
|
# 若将来又改回 nginx 托管并启用 gzip_static,可删除本行或改为 true。
|
VITE_COMPRESSION=false
|
|
# 验证码的开关
|
VITE_APP_CAPTCHA_ENABLE=false
|