Spring AI Alibaba 与 DashScope 调用超时问题修复方案

问题背景

在使用 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 生成复杂回答时，服务器响应时间往往需要 60180 秒甚至更长。 而 Spring AI Alibaba 默认的 read timeout（读取超时）通常只有 1030 秒。 客户端等不到完整响应，就主动断开连接，从而抛出 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 建议设置为 180300 秒（35 分钟），基本能覆盖绝大多数场景
• 重要：不要设置得过长（如 10 分钟以上），防止恶意请求占用资源
• 建议把超时时间做成多环境配置（dev/test/prod）

总结

这个超时问题的根本原因是 DashScope 生成长回答耗时较长，而客户端默认读取超时过短。 通过使用 Spring Boot 官方的 RestClientCustomizer 进行全局配置，我们实现了：

• 配置集中管理
• 不依赖具体 starter 的内部 API
• 版本升级时基本不需改代码
• 彻底解决长回答超时问题