Spring AI Alibaba + DashScope 调用超时彻底解决（SocketTimeoutException / read timeout）

长回答、复杂问题必超时？5 分钟彻底解决!

一、问题现象

在使用 Spring AI Alibaba 集成 DashScope（通义千问） 构建 Agent 时，经常遇到以下问题：

• 简单问题正常回答
• 一旦用户提出较复杂、需要较长回答的问题（如投资组合配置、退休规划、详细分析等），就会出现超时
• 报错核心信息：

SocketTimeoutException: timeout
I/O error on POST request for "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation": timeout

• Spring Retry 会尝试重试几次，但最终仍然失败
• 短问题不报错，长回答几乎必现
  这个问题在生成内容较长时特别明显，是很多开发者在使用 Spring AI Alibaba 过程中都会踩到的坑。

二、根本原因

DashScope 生成复杂回答时，服务器响应时间往往需要 60~180 秒 甚至更长。

而 Spring AI Alibaba 默认的 read timeout（读取超时） 通常只有 10~30 秒 。

客户端等不到完整响应，就主动断开连接，从而抛出 SocketTimeoutException。

这是典型的客户端超时配置过短导致的问题，而不是网络问题或模型本身故障。

三、曾经尝试过但失败的方案

• 在 DashScopeApi.builder() 中寻找 restClientBuilder、readTimeout 等方法 → 编译报错，方法不存在
• 使用 RestTemplate 手动设置超时再传入 → 部分版本不支持 restTemplate 参数
• 在 application.yml 中尝试 spring.ai.dashscope.rest.read-timeout → 配置项不存在
• 调大 Spring Retry 次数 → 治标不治本，每次还是超时
  这些方案要么依赖特定版本的内部 API，要么配置项根本不存在，容易因版本升级而失效。

四、最终稳定有效的解决方案

核心思路 ：使用 Spring Boot 官方提供的 RestClientCustomizer 全局配置超时。

这种方式是 Spring 官方推荐的标准化扩展点，兼容性强，几乎不会因版本升级而失效。

方案1：新建配置类 RestClientConfig.java

package com.ckg.kgaiagent.config;
import org.springframework.boot.web.client.RestClientCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ClientHttpRequestFactories;
import org.springframework.http.client.ClientHttpRequestFactorySettings;
import java.time.Duration;
@Configuration
public class RestClientConfig {
    @Bean
    public RestClientCustomizer restClientCustomizer() {
        return restClientBuilder -> {
            restClientBuilder.requestFactory(ClientHttpRequestFactories.get(
                ClientHttpRequestFactorySettings.DEFAULTS
                    .withConnectTimeout(Duration.ofSeconds(10))    // 连接超时
                    .withReadTimeout(Duration.ofSeconds(300))      // 读取超时 5 分钟（最关键！）
            ));
        };
    }
}

方案2：application.yml（推荐可配置化）

app:
  http:
    connect-timeout: 10
    read-timeout: 300        # 单位：秒，建议 180~300 秒（3~5 分钟）

@Configuration
public class RestClientConfig {

    @Value("${app.http.connect-timeout:10s}")
    private Duration connectTimeout;

    @Value("${app.http.read-timeout:300s}")
    private Duration readTimeout;

    @Bean
    public RestClientCustomizer restClientCustomizer() {
        return restClientBuilder -> {
            restClientBuilder.requestFactory(ClientHttpRequestFactories.get(
                    ClientHttpRequestFactorySettings.DEFAULTS
                            .withConnectTimeout(connectTimeout)    // 从 yml 读取，单位秒
                            .withReadTimeout(readTimeout)          // 从 yml 读取，单位秒
            ));
        };
    }
}

---

五、验证方法

1. 重启项目
2. 故意问一个很长、很复杂的问题 ，例如：
   • "我22岁，有5万块闲钱，想开始理财，请给出详细的投资组合配置建议，包括股票、基金、债券的比例和理由"
3. 查看日志是否还有超时异常
4. 观察回答是否能完整返回（不再中途中断）
   如果回答能完整输出，说明问题已解决。

---

六、生产环境建议

• read-timeout 建议设置为 180~300 秒（3~5 分钟），基本能覆盖绝大多数场景
• 重要：不要设置得过长（如 10 分钟以上），防止恶意请求占用资源
• 建议把超时时间做成多环境配置（dev/test/prod）

---

七、总结

这个超时问题的根本原因是 DashScope 生成长回答耗时较长，而客户端默认读取超时过短 。

通过使用 Spring Boot 官方的 RestClientCustomizer 进行全局配置，我们实现了：

• 配置集中管理
• 不依赖具体 starter 的内部 API
• 版本升级时基本不需改代码
• 彻底解决长回答超时问题
  希望这篇文章能帮助到同样遇到这个问题的朋友。
  如果你也遇到了类似问题，欢迎在评论区留言，我会尽量回复。

---