spring-ai MCP Server运行一段时间后断联

原创已于 2025-06-11 18:25:48 修改 · 1.3k 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#mcp

于 2025-06-10 11:07:29 首次发布

背景：

mcp server 的java sdk有两种：

官方(star 1.8k)：https://github.com/modelcontextprotocol/java-sdk

sping-ai(star 5.7k):GitHub - spring-projects/spring-ai: An Application Framework for AI Engineering

SSE Timeout Error After 5 Minutes - Bug Reports - Cursor - Community Forum

问题：

为什么使用spring-ai-starter-mcp-server-webmvc的1.0.0-M8运行一段时间就连不上了，需要重启才能重新连上。该依赖源码可参考https://github.com/spring-projects/spring-ai，可从该项目的issue中搜索有没有类似问题

回答（测试感觉不好使）：

我来帮您搜索一下 spring-ai 项目中关于 `spring-ai-starter-mcp-server-webmvc` 1.0.0-M8 版本连接断开问题的相关 issues。
Ran tool
让我再次搜索相关问题：
Ran tool
Ran tool
让我继续搜索更多关于这个问题的信息：
Ran tool
根据我的搜索结果，我找到了您遇到的问题的详细信息和解决方案。这是一个在 `spring-ai-starter-mcp-server-webmvc` 1.0.0-M8 版本中已知的 SSE 连接超时问题。

## 问题原因

您遇到的 `"Cannot invoke 'org.apache.catalina.connector.OutputBuffer.isBlocking()' because 'this.ob' is null"` 错误主要由以下原因引起：

1. **SSE 连接超时**：MCP Server 的 SSE（Server-Sent Events）连接在默认情况下会在 30 秒后超时断开
2. **客户端连接丢失**：客户端连接可能在 API 调用期间已经断开或超时
3. **Tomcat 连接超时**：底层的 Tomcat servlet 容器连接超时配置过短

## 解决方案

根据 GitHub issue 中的讨论，这个问题已经在相关的 Java SDK 中得到修复。以下是几种解决方案：

### 1. 升级 Spring AI 版本（推荐）

将 Spring AI 版本升级到 **1.0.0-M7 或更高版本**：

```xml
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
<version>1.0.0-M7</version> 
</dependency>
```

根据 issue 反馈，升级到 1.0.0-M7 后问题得到解决。

### 2. 配置 Tomcat 连接超时

在 `application.yml` 或 `application.properties` 中增加 Tomcat 超时配置：

```yaml
server:
tomcat:
connection-timeout: 180000 # 设置为3分钟 (180,000毫秒)
```

或者在 `application.properties` 中：

```properties
server.tomcat.connection-timeout=180000
```

### 3. 配置 MCP Server 请求超时

增加 MCP 服务器的请求超时配置：

```yaml
spring:
ai:
mcp:
server:
request-timeout: 90s # 增加请求超时时间
```

### 4. 考虑使用 WebFlux 替代 WebMVC

根据 issue 中的反馈，使用 `spring-ai-starter-mcp-server-webflux` 替代 `spring-ai-starter-mcp-server-webmvc` 可以避免这个问题：

```xml
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
<version>1.0.0-M8</version>
</dependency>
```

## 相关 GitHub Issues

这个问题在以下 GitHub issues 中有详细讨论：

- **[Spring AI #2267](https://github.com/spring-projects/spring-ai/issues/2267)** - 已在 2025年2月25日关闭，通过 Java SDK 修复解决
- **[Spring AI #2710](https://github.com/spring-projects/spring-ai/issues/2710)** - 通过升级到 1.0.0-M7 解决
- **[Java SDK #21](https://github.com/modelcontextprotocol/java-sdk/pull/21)** - 修复了 SSE 连接30秒后终止的问题

## 建议

1. **立即解决方案**：升级到 Spring AI 1.0.0-M7 或更高版本
2. **配置优化**：增加 Tomcat 连接超时和 MCP 请求超时设置
3. **长期考虑**：如果问题持续存在，可以考虑迁移到 WebFlux 实现

这个问题已经被开发团队识别并修复，升级版本应该是最直接有效的解决方案。