Skip to content

文件上传与管理 ​

INF-FILE-01 | 模块 infra | 统一收口文件上传、下载、预览与删除,业务方只存 URL 不关心存储实现。

1. 使用角色与场景 ​

角色:终端用户、管理员

  • 头像上传走本地存储
  • 合同附件走 S3 并生成带时效的预签名地址

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/infra/file/upload—上传文件FileController#L46
GET/infra/file/presigned-url—获取文件预签名地址(上传)FileController#L57
POST/infra/file/create—创建文件FileController#L69
GET/infra/file/getinfra:file:query获得文件FileController#L75
DELETE/infra/file/deleteinfra:file:delete删除文件FileController#L83
DELETE/infra/file/delete-listinfra:file:delete批量删除文件FileController#L92
GET/infra/file/{configId}/get/**—下载文件FileController#L101
GET/infra/file/pageinfra:file:query获得文件分页FileController#L129
POST/infra/file/upload—上传文件AppFileController#L35
GET/infra/file/presigned-url—获取文件预签名地址(上传)AppFileController#L47
POST/infra/file/create—创建文件AppFileController#L59

3. 代码定位 ​

层位置
Controllermodules/infra/src/main/java/com/pmforge/module/infra/controller/admin/file/FileController.java#L46
Controllermodules/infra/src/main/java/com/pmforge/module/infra/controller/app/file/AppFileController.java#L35
DOmodules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/file/FileDO.java

4. 数据表 ​

表DO
infra_fileFileDO

5. 机制与配置 ​

  • FileClient 抽象 + local/ftp/sftp/s3/db 五种实现 + 工厂按配置选择
  • 文件元信息落库,内容按配置存储

6. 常见问题与排查 ​

  • 预签名地址过期会导致前端 403
  • 大文件上传要确认 Nginx/网关的 body 限制

7. 关联 ​