docs(file): FILE_UPLOAD_PATH 注释改为配置文件顶层键口径（与 flow-center 的 FILE_PATH 同玩法，环境变量亦可）

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）。
-     * 优先级：环境变量 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;