From b96de59b6d8e4017f9c89a837193933dc77d750b Mon Sep 17 00:00:00 2001 From: chenxing Date: Sat, 10 Oct 2026 15:54:07 +0800 Subject: [PATCH] =?UTF-8?q?docs(file):=20FILE=5FUPLOAD=5FPATH=20=E6=B3=A8?= =?UTF-8?q?=E9=87=8A=E6=94=B9=E4=B8=BA=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E9=A1=B6=E5=B1=82=E9=94=AE=E5=8F=A3=E5=BE=84=EF=BC=88=E4=B8=8E?= =?UTF-8?q?=20flow-center=20=E7=9A=84=20FILE=5FPATH=20=E5=90=8C=E7=8E=A9?= =?UTF-8?q?=E6=B3=95=EF=BC=8C=E7=8E=AF=E5=A2=83=E5=8F=98=E9=87=8F=E4=BA=A6?= =?UTF-8?q?=E5=8F=AF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../java/com/yunhai/notice/service/impl/FileService.java | 8 +++++--- src/main/resources/application.yml | 8 ++++---- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/src/main/java/com/yunhai/notice/service/impl/FileService.java b/src/main/java/com/yunhai/notice/service/impl/FileService.java index 08b4576..2b95e4c 100644 --- a/src/main/java/com/yunhai/notice/service/impl/FileService.java +++ b/src/main/java/com/yunhai/notice/service/impl/FileService.java @@ -55,10 +55,12 @@ public class FileService implements IFileService { /** * 附件存储根目录（生产容器内 /data/upload，对应 projman 卷 /data/uploads/notice）。 - * 优先级：环境变量 FILE_UPLOAD_PATH（子应用平台新标准，projman 注入）> file.upload-path - * （application.yml 的 D:/data/upload，仅本地 Windows 开发用）> /data/upload 兜底。 + * 优先级：属性 FILE_UPLOAD_PATH（子应用平台新标准，与其他子应用同款加在 + * 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 - * 写进容器可写层，每次重新部署文件即丢（2026-10 事故），故 prod 必须注入该环境变量。 + * 写进容器可写层，每次重新部署文件即丢（2026-10 事故），故生产配置必须带该键。 */ @Value("${FILE_UPLOAD_PATH:${file.upload-path:/data/upload}}") private String uploadPath; diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 56922fb..4d30471 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -41,10 +41,10 @@ spring: simple: auto-startup: false -# 文件上传存储路径——仅供本地 Windows 开发兜底；生产以 projman 注入的环境变量 -# FILE_UPLOAD_PATH=/data/upload 为准（子应用平台新标准，卷 /data/uploads/notice 对应容器 /data/upload）。 -# 切勿在生产只依赖本键：历史教训是 Linux 容器把 D:/data/upload 锚定成 /app/D:/data/upload -# 写进容器可写层，每次更新部署附件全部丢失（2026-10）。 +# 文件上传存储路径——仅供本地 Windows 开发兜底；生产在 application-prod.yml 顶层加 +# FILE_UPLOAD_PATH: /data/upload（子应用平台新标准，与 flow-center 的 FILE_PATH 同玩法， +# 同名环境变量亦可），切勿在生产只依赖本键：历史教训是 Linux 容器把 D:/data/upload +# 锚定成 /app/D:/data/upload 写进容器可写层，每次更新部署附件全部丢失（2026-10）。 file: upload-path: D:/data/upload