docs(file): FILE_UPLOAD_PATH 注释改为配置文件顶层键口径(与 flow-center 的 FILE_PATH 同玩法,环境变量亦可)
build / build-push (push) Successful in 2m38s

This commit is contained in:
chenxing
2026-10-10 15:54:07 +08:00
parent a4e8702dc0
commit b96de59b6d
2 changed files with 9 additions and 7 deletions
@@ -55,10 +55,12 @@ public class FileService implements IFileService {
/** /**
* 附件存储根目录(生产容器内 /data/upload,对应 projman 卷 /data/uploads/notice)。 * 附件存储根目录(生产容器内 /data/upload,对应 projman 卷 /data/uploads/notice)。
* 优先级:环境变量 FILE_UPLOAD_PATH(子应用平台新标准,projman 注入)> file.upload-path * 优先级:属性 FILE_UPLOAD_PATH(子应用平台新标准,与其他子应用同款加在
* (application.yml 的 D:/data/upload,仅本地 Windows 开发用)> /data/upload 兜底。 * application-prod.yml 顶层:FILE_UPLOAD_PATH: /data/upload;同名环境变量亦可)
* > file.upload-path(application.yml 的 D:/data/upload,仅本地 Windows 开发用)
* > /data/upload 兜底。
* 生产缺 FILE_UPLOAD_PATH 时曾回落到 D:/data/upload——Linux 下锚定为 /app/D:/data/upload * 生产缺 FILE_UPLOAD_PATH 时曾回落到 D:/data/upload——Linux 下锚定为 /app/D:/data/upload
* 写进容器可写层,每次重新部署文件即丢(2026-10 事故),故 prod 必须注入该环境变量。 * 写进容器可写层,每次重新部署文件即丢(2026-10 事故),故生产配置必须带该键。
*/ */
@Value("${FILE_UPLOAD_PATH:${file.upload-path:/data/upload}}") @Value("${FILE_UPLOAD_PATH:${file.upload-path:/data/upload}}")
private String uploadPath; private String uploadPath;
+4 -4
View File
@@ -41,10 +41,10 @@ spring:
simple: simple:
auto-startup: false auto-startup: false
# 文件上传存储路径——仅供本地 Windows 开发兜底;生产以 projman 注入的环境变量 # 文件上传存储路径——仅供本地 Windows 开发兜底;生产在 application-prod.yml 顶层加
# FILE_UPLOAD_PATH=/data/upload 为准(子应用平台新标准,卷 /data/uploads/notice 对应容器 /data/upload)。 # FILE_UPLOAD_PATH: /data/upload(子应用平台新标准,与 flow-center 的 FILE_PATH 同玩法,
# 切勿在生产只依赖本键:历史教训是 Linux 容器把 D:/data/upload 锚定成 /app/D:/data/upload # 同名环境变量亦可),切勿在生产只依赖本键:历史教训是 Linux 容器把 D:/data/upload
# 写进容器可写层,每次更新部署附件全部丢失(2026-10)。 # 锚定成 /app/D:/data/upload 写进容器可写层,每次更新部署附件全部丢失(2026-10)。
file: file:
upload-path: D:/data/upload upload-path: D:/data/upload