From 012fa46d3a77c08d65bf8d5bebb0d74254a00bac Mon Sep 17 00:00:00 2001
From: Peanut <peanut_hzm@163.com>
Date: Wed, 3 Jun 2026 22:46:30 +0800
Subject: [PATCH] =?UTF-8?q?feat(wechat):=20=E9=87=8D=E5=86=99=20RestTempla?=
 =?UTF-8?q?teConfig=20=E7=BB=9F=E4=B8=80=20RestTemplate=20Bean?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

解决问题：
- WAF 拦截 Java/17.0.x 默认 User-Agent
- 无超时设置（线程可能被 hang 住）
- 无请求/响应日志（出问题时无排查依据）

改动：
- 用 BufferingClientHttpRequestFactory 包装 SimpleClientHttpRequestFactory
  （响应体缓存为字节数组，Interceptor/ErrorHandler/Converter 可多次读）
- 显式 User-Agent: Mozilla/5.0 (compatible; EmotionMuseum/1.0)
- 显式 Accept: application/json, text/plain, */*
- connect timeout 5s, read timeout 10s
- additionalInterceptors 加 WechatApiLoggingInterceptor（脱敏）
- additionalMessageConverters 加 StringHttpMessageConverter(UTF_8)
- errorHandler 用 WechatResponseErrorHandler（4xx/5xx 不抛）

兼容性：
- 7 个其他 RestTemplate 使用点（DifyProviderAdapter、
  CozeProviderAdapter、HttpTtsEngineClient、AsrServiceImpl、
  ApiEndpointServiceImpl、AiChatServiceImpl、ApiTestProxyController）
  行为完全不变（BufferingClientHttpRequestFactory 兼容所有流式 API）
---
 .../emotion/config/RestTemplateConfig.java    | 45 +++++++++++++++++--
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/backend-single/src/main/java/com/emotion/config/RestTemplateConfig.java b/backend-single/src/main/java/com/emotion/config/RestTemplateConfig.java
index 26329c8..3ad4d55 100644
--- a/backend-single/src/main/java/com/emotion/config/RestTemplateConfig.java
+++ b/backend-single/src/main/java/com/emotion/config/RestTemplateConfig.java
@@ -1,13 +1,52 @@
 package com.emotion.config;
 
+import com.emotion.interceptor.WechatApiLoggingInterceptor;
+import org.springframework.boot.web.client.RestTemplateBuilder;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.http.client.BufferingClientHttpRequestFactory;
+import org.springframework.http.client.SimpleClientHttpRequestFactory;
+import org.springframework.http.converter.StringHttpMessageConverter;
 import org.springframework.web.client.RestTemplate;
 
+import java.nio.charset.StandardCharsets;
+import java.time.Duration;
+
+/**
+ * 统一 RestTemplate Bean
+ *
+ * <p>设计要点：
+ * <ol>
+ *   <li>用 BufferingClientHttpRequestFactory 包装 SimpleClientHttpRequestFactory，
+ *       响应体被缓存到字节数组，可被 Interceptor / ErrorHandler / Converter 多次读取
+ *       （避免破坏其他 7 个 RestTemplate 使用点：DifyProviderAdapter、
+ *       CozeProviderAdapter、HttpTtsEngineClient、AsrServiceImpl、
+ *       ApiEndpointServiceImpl、AiChatServiceImpl、ApiTestProxyController）</li>
+ *   <li>显式设置 User-Agent 为 Mozilla/5.0，绕过 WAF / CloudFlare 对 Java/* 默认 UA 的拦截</li>
+ *   <li>显式设置连接 / 读取超时，避免线程被 hang 住</li>
+ *   <li>加 StringHttpMessageConverter(UTF_8) 支持 text/plain 响应</li>
+ *   <li>加 WechatApiLoggingInterceptor 记录请求 / 响应（脱敏）</li>
+ *   <li>加 WechatResponseErrorHandler 4xx/5xx 不抛异常</li>
+ * </ol>
+ */
 @Configuration
 public class RestTemplateConfig {
+
     @Bean
-    public RestTemplate restTemplate() {
-        return new RestTemplate();
+    public RestTemplate restTemplate(RestTemplateBuilder builder) {
+        SimpleClientHttpRequestFactory simpleFactory = new SimpleClientHttpRequestFactory();
+        simpleFactory.setConnectTimeout((int) Duration.ofSeconds(5).toMillis());
+        simpleFactory.setReadTimeout((int) Duration.ofSeconds(10).toMillis());
+        BufferingClientHttpRequestFactory bufferingFactory =
+            new BufferingClientHttpRequestFactory(simpleFactory);
+
+        return builder
+            .requestFactory(() -> bufferingFactory)
+            .defaultHeader("User-Agent", "Mozilla/5.0 (compatible; EmotionMuseum/1.0)")
+            .defaultHeader("Accept", "application/json, text/plain, */*")
+            .additionalMessageConverters(new StringHttpMessageConverter(StandardCharsets.UTF_8))
+            .additionalInterceptors(new WechatApiLoggingInterceptor())
+            .errorHandler(new WechatResponseErrorHandler())
+            .build();
     }
-} 
\ No newline at end of file
+}