yxh
yxh
2026-11-08 09dc74e264b6262cbe41c9c8476e24705871d4a6
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# =============================================================================
# 合并部署环境(前端打进 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