diff --git a/Java/spring-cloud-gateway-server-webmvc-unsupported-transfer-encoding-chunked.md b/Java/spring-cloud-gateway-server-webmvc-unsupported-transfer-encoding-chunked.md
new file mode 100644
index 0000000000000000000000000000000000000000..9a5e8da17d28e58143c0cf5b443a9de3e3977c33
--- /dev/null
+++ b/Java/spring-cloud-gateway-server-webmvc-unsupported-transfer-encoding-chunked.md
@@ -0,0 +1,126 @@
+
+我主要是把我最近遇到的比较坑的问题Spring Cloud Gateway Server Web MVC中报错“Unsupported transfer encoding: chunked”跟大家分享一下。该问题我之前也在[OSCHINA博客](https://my.oschina.net/waylau/blog/18686375)上发表过，当时排查该问题花费一周时间，也算是坑爹代码。
+
+=====================
+
+
+本文主要介绍在Spring Cloud Gateway Server Web MVC中报错“Unsupported transfer encoding: chunked”问题的原因，及解决方案。
+
+
+
+`org.apache.hc.core5.http.NotImplementedException: Unsupported Unsupported transfer encoding: chunked` 错误通常是由于 **Feign 依赖的 HTTP 客户端与服务端使用的 `chunked` 传输编码不兼容** 导致的。具体原因和解决方案如下：
+
+
+## 原因分析
+
+
+基于Spring Cloud Gateway Server Web MVC的API网关问题控制台输出报错信息如下：
+
+
+```
+org.apache.hc.core5.http.NotImplementedException: Unsupported transfer encoding: chunked
+	at org.apache.hc.core5.http.impl.DefaultContentLengthStrategy.determineLength(DefaultContentLengthStrategy.java:90) ~[httpcore5-5.3.4.jar:5.3.4]
+	at org.apache.hc.core5.http.impl.io.DefaultBHttpClientConnection.receiveResponseEntity(DefaultBHttpClientConnection.java:355) ~[httpcore5-5.3.4.jar:5.3.4]
+	at org.apache.hc.core5.http.impl.io.HttpRequestExecutor.execute(HttpRequestExecutor.java:213) ~[httpcore5-5.3.4.jar:5.3.4]
+	at org.apache.hc.client5.http.impl.classic.InternalExecRuntime.lambda$execute$0(InternalExecRuntime.java:236) ~[httpclient5-5.4.4.jar:5.4.4]
+	at org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager$InternalConnectionEndpoint.execute(PoolingHttpClientConnectionManager.java:791) ~[httpclient5-5.4.4.jar:5.4.4]
+	at org.apache.hc.client5.http.impl.classic.InternalExecRuntime.execute(InternalExecRuntime.java:233) ~[httpclient5-5.4.4.jar:5.4.4]
+```
+
+虽然错误是报在API网关，但实际是需要在微服务中去解决。问题原因如下：
+
+
+
+HTTP 中的 `chunked` 传输编码用于动态分块传输数据（适用于数据大小不确定的场景）。该错误表明：
+- 服务端返回的响应使用了 `Transfer-Encoding: chunked` 编码。
+- Feign 客户端使用的 HTTP 客户端（如 Apache HttpClient 5.x）不支持或未正确配置 `chunked` 编码处理。
+
+
+## 解决方案
+
+REST接口类型尽量采用具体类型，避免 Feign 客户端调用过程中导致推导类型失真。
+
+例如：
+
+```java
+@FeignClient(
+        name = "rednote-content-microservice",
+        fallback = ContentServiceClientFallback.class // 指定降级实现类
+)
+public interface ContentServiceClient {
+    @GetMapping("/note/user/{userId}")
+    ResponseEntity<?> getNotesWithUser(
+            @PathVariable Long userId,
+            @RequestParam(defaultValue = "1") int page,
+            @RequestParam(defaultValue = "12") int size);
+}
+```
+
+改为：
+
+```java
+@FeignClient(
+        name = "rednote-content-microservice",
+        fallback = ContentServiceClientFallback.class // 指定降级实现类
+)
+public interface ContentServiceClient {
+    @GetMapping("/note/user/{userId}")
+    ResponseEntity<NotesWithUserDto> getNotesWithUser(
+            @PathVariable Long userId,
+            @RequestParam(defaultValue = "1") int page,
+            @RequestParam(defaultValue = "12") int size);
+}
+```
+
+```java
+@GetMapping("/user/{userId}")
+public ResponseEntity<?> getNotesWithUser(
+        @PathVariable Long userId,
+        @RequestParam(defaultValue = "1") int page,
+        @RequestParam(defaultValue = "12") int size) {
+    ResponseEntity<UserDto> response = userServiceClient.findByUserId(userId);
+    UserDto user = response.getBody();
+
+    // 获取用户笔记列表（分页）
+    Page<Note> notePage = noteService.getNotesByUser(userId, page - 1, size);
+
+    // 转换为 DTO
+    List<NoteExploreDto> noteExploreDtoList = notePage.map(note -> noteService.toExploreDto(note, user)).getContent();
+
+    Map<String, Object> map = new HashMap<>();
+    map.put("user", user);
+    map.put("noteList", noteExploreDtoList);
+    map.put("currentPage", page);
+    map.put("totalPages", notePage.getTotalPages());
+
+    return ResponseEntity.ok()
+            .body(map);
+}
+```
+
+
+改为：
+
+
+```java
+@GetMapping("/user/{userId}")
+public ResponseEntity<?> getNotesWithUser(
+        @PathVariable Long userId,
+        @RequestParam(defaultValue = "1") int page,
+        @RequestParam(defaultValue = "12") int size) {
+    ResponseEntity<UserDto> response = userServiceClient.findByUserId(userId);
+    UserDto user = response.getBody();
+
+    // 获取用户笔记列表（分页）
+    Page<Note> notePage = noteService.getNotesByUser(userId, page - 1, size);
+
+    // 转换为 DTO
+    List<NoteExploreDto> noteExploreDtoList = notePage.map(note -> noteService.toExploreDto(note, user)).getContent();
+
+    NotesWithUserDto dto = new NotesWithUserDto(user, noteExploreDtoList, page, notePage.getTotalPages());
+    ResponseEntity<NotesWithUserDto> responseEntity = ResponseEntity.ok()
+            .body(dto);
+    return responseEntity;
+}
+```
+