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 ec31a6c..08b4576 100644
--- a/src/main/java/com/yunhai/notice/service/impl/FileService.java
+++ b/src/main/java/com/yunhai/notice/service/impl/FileService.java
@@ -53,7 +53,14 @@ public class FileService implements IFileService {
     @Autowired
     private UpFileRepository upFileRepository;
 
-    @Value("${file.upload-path}")
+    /**
+     * 附件存储根目录（生产容器内 /data/upload，对应 projman 卷 /data/uploads/notice）。
+     * 优先级：环境变量 FILE_UPLOAD_PATH（子应用平台新标准，projman 注入）> 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 必须注入该环境变量。
+     */
+    @Value("${FILE_UPLOAD_PATH:${file.upload-path:/data/upload}}")
     private String uploadPath;
 
     private static final String DEFAULT_APP_TYPE = "notice";
diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml
index 7ccb0d9..56922fb 100644
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -41,7 +41,10 @@ spring:
       simple:
         auto-startup: false
 
-# 文件上传存储路径（Docker 部署时与 volume 挂载一致）
+# 文件上传存储路径——仅供本地 Windows 开发兜底；生产以 projman 注入的环境变量
+# FILE_UPLOAD_PATH=/data/upload 为准（子应用平台新标准，卷 /data/uploads/notice 对应容器 /data/upload）。
+# 切勿在生产只依赖本键：历史教训是 Linux 容器把 D:/data/upload 锚定成 /app/D:/data/upload
+# 写进容器可写层，每次更新部署附件全部丢失（2026-10）。
 file:
   upload-path: D:/data/upload