feat(oss): 实现文件上传功能并集成Feign调用

- 新增文件上传接口，支持multipart/form-data格式
- 配置Spring Servlet multipart参数，设置文件大小限制
- 添加Feign客户端配置，支持表单提交
- 实现Feign请求拦截器，传递用户上下文信息
- 创建OSS服务API接口，用于文件上传
- 在用户服务中集成OSS RPC调用，实现头像和背景图上传
- 添加上传失败的业务异常处理
- 更新pom.xml依赖，引入OpenFeign、负载均衡及Feign表单相关组件
- 定义API常量和服务名称
- 启用Feign客户端扫描，支持跨服务调用

han-note-oss/han-note-oss-api/pom.xml

@@ -20,5 +20,24 @@
             <groupId>com.hanserwei</groupId>
             <artifactId>hanserwei-common</artifactId>
         </dependency>
+        <!-- OpenFeign -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+        </dependency>
+        <!-- 负载均衡 -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+        </dependency>
+        <!-- Feign 表单提交 -->
+        <dependency>
+            <groupId>io.github.openfeign.form</groupId>
+            <artifactId>feign-form-spring</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.github.openfeign.form</groupId>
+            <artifactId>feign-form</artifactId>
+        </dependency>
     </dependencies>
 </project>

han-note-oss/han-note-oss-api/src/main/java/com/hanserwei/hannote/oss/api/FileFeignApi.java

@@ -0,0 +1,26 @@
+package com.hanserwei.hannote.oss.api;
+
+import com.hanserwei.framework.common.response.Response;
+import com.hanserwei.hannote.oss.config.FeignFormConfig;
+import com.hanserwei.hannote.oss.constant.ApiConstants;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.http.MediaType;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.multipart.MultipartFile;
+
+@FeignClient(name = ApiConstants.SERVICE_NAME, configuration = FeignFormConfig.class)
+public interface FileFeignApi {
+
+    String PREFIX = "/file";
+
+    /**
+     * 文件上传
+     * 
+     * @param file 文件
+     * @return 文件上传结果
+     */
+    @PostMapping(value = PREFIX + "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    Response<?> uploadFile(@RequestPart(value = "file") MultipartFile file);
+
+}

han-note-oss/han-note-oss-api/src/main/java/com/hanserwei/hannote/oss/config/FeignFormConfig.java

@@ -0,0 +1,16 @@
+package com.hanserwei.hannote.oss.config;
+
+import feign.codec.Encoder;
+import feign.form.spring.SpringFormEncoder;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+
+@Configuration
+public class FeignFormConfig {
+
+    @Bean
+    public Encoder feignFormEncoder() {
+        return new SpringFormEncoder();
+    }
+}

han-note-oss/han-note-oss-api/src/main/java/com/hanserwei/hannote/oss/constant/ApiConstants.java

@@ -0,0 +1,9 @@
+package com.hanserwei.hannote.oss.constant;
+
+public interface ApiConstants {
+
+    /**
+     * 服务名称
+     */
+    String SERVICE_NAME = "han-note-oss";
+}

han-note-oss/han-note-oss-biz/pom.xml

@@ -75,6 +75,23 @@
             <groupId>com.qcloud</groupId>
             <artifactId>cos_api</artifactId>
         </dependency>
+        <dependency>
+            <groupId>com.hanserwei</groupId>
+            <artifactId>hanserwei-spring-boot-starter-biz-operationlog</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.hanserwei</groupId>
+            <artifactId>hanserwei-spring-boot-starter-jackson</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.hanserwei</groupId>
+            <artifactId>han-note-oss-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.hanserwei</groupId>
+            <artifactId>hanserwei-spring-boot-starter-biz-context</artifactId>
+        </dependency>
+
     </dependencies>
 
     <build>

han-note-oss/han-note-oss-biz/src/main/java/com/hanserwei/hannote/oss/controller/FileController.java

@@ -1,5 +1,6 @@
 package com.hanserwei.hannote.oss.controller;
 
+import com.hanserwei.framework.biz.context.holder.LoginUserContextHolder;
 import com.hanserwei.framework.common.response.Response;
 import com.hanserwei.hannote.oss.service.FileService;
 import jakarta.annotation.Resource;
@@ -21,6 +22,7 @@ public class FileController {
 
     @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
     public Response<?> uploadFile(@RequestPart(value = "file") MultipartFile file) {
+        log.info("当前用户 ID: {}", LoginUserContextHolder.getUserId());
         return fileService.uploadFile(file);
     }
 

han-note-oss/han-note-oss-biz/src/main/resources/application.yml

@@ -4,6 +4,10 @@ server:
 spring:
   profiles:
     active: dev # 默认激活 dev 本地开发环境
+  servlet:
+    multipart:
+      max-file-size: 20MB       # 单个文件最大大小
+      max-request-size: 100MB   # 单次请求最大大小（包含多个文件）
 
 storage:
   type: rustfs # 对象存储类型