Spring AI 1.x 系列【59】容器化开发支持：Docker Compose 与 Testcontainers

1. 概述

在开发 Spring AI 应用时，经常需要连接各种外部服务 ------ 模型服务（如 Ollama）、向量数据库（如 Chroma、Qdrant、Weaviate、Milvus、OpenSearch）、MCP 网关等。手动安装和配置这些服务既繁琐又容易出错。

Spring AI 提供了两种开箱即用的容器化解决方案，让开发者无需关心服务连接细节：

方案	适用阶段	原理
`Docker Compose`	本地开发	通过 `Docker Compose` 启动服务容器，`Spring Boot` 自动配置连接
`Testcontainers`	集成测试	通过 `Testcontainers` 在测试中动态启动容器，测试结束自动销毁

两者的共同优势：只需添加一个依赖，无需手动配置连接参数 。Spring AI 会通过服务连接工厂（Service Connection Factory）自动探测容器并建立连接。

Spring AI 提供了 Spring Boot 自动配置，用于连接通过 Docker Compose 运行的模型服务或向量数据库。

Maven（pom.xml）：

xml 复制代码

<dependency>
   <groupId>org.springframework.ai</groupId>
   <artifactId>spring-ai-spring-boot-docker-compose</artifactId>
</dependency>

Gradle（build.gradle）：

groovy 复制代码

dependencies {
    implementation 'org.springframework.ai:spring-ai-spring-boot-docker-compose'
}

📖 请参阅依赖管理章节，将 Spring AI BOM 添加到你的构建文件中。

spring-ai-spring-boot-docker-compose 模块提供了以下服务连接工厂：

连接详情（Connection Details）	匹配容器镜像
`AwsOpenSearchConnectionDetails`	`localstack/localstack`
`ChromaConnectionDetails`	`chromadb/chroma`、`ghcr.io/chroma-core/chroma`
`MongoConnectionDetails`	`mongodb/mongodb-atlas-local`
`OllamaConnectionDetails`	`ollama/ollama`
`OpenSearchConnectionDetails`	`opensearchproject/opensearch`
`QdrantConnectionDetails`	`qdrant/qdrant`
`TypesenseConnectionDetails`	`typesense/typesense`
`WeaviateConnectionDetails`	`semitechnologies/weaviate`、`cr.weaviate.io/semitechnologies/weaviate`
`McpSseClientConnectionDetails`	`docker/mcp-gateway`

📖 Spring Boot 的 spring-boot-docker-compose 模块提供了更多通用服务连接。完整列表请参阅 Docker Compose Support 文档。

Spring AI 提供了 Spring Boot 自动配置，用于连接通过 Testcontainers 运行的模型服务或向量数据库。

Maven（pom.xml）：

xml 复制代码

<dependency>
   <groupId>org.springframework.ai</groupId>
   <artifactId>spring-ai-spring-boot-testcontainers</artifactId>
</dependency>

Gradle（build.gradle）：

groovy 复制代码

dependencies {
    implementation 'org.springframework.ai:spring-ai-spring-boot-testcontainers'
}

📖 请参阅依赖管理章节，将 Spring AI BOM 添加到你的构建文件中。

spring-ai-spring-boot-testcontainers 模块提供了以下服务连接工厂：

连接详情（`Connection Details`）	匹配容器类型
`AwsOpenSearchConnectionDetails`	`LocalStackContainer`
`ChromaConnectionDetails`	`ChromaDBContainer`
`McpSseClientConnectionDetails`	`DockerMcpGatewayContainer`
`MilvusServiceClientConnectionDetails`	`MilvusContainer`
`MongoConnectionDetails`	`MongoDBAtlasLocalContainer`
`OllamaConnectionDetails`	`OllamaContainer`
`OpenSearchConnectionDetails`	`OpensearchContainer`
`QdrantConnectionDetails`	`QdrantContainer`
`TypesenseConnectionDetails`	`TypesenseContainer`
`WeaviateConnectionDetails`	`WeaviateContainer`

📖 Spring Boot 的 spring-boot-testcontainers 模块提供了更多通用服务连接。完整列表请参阅 Testcontainers Service Connections 文档。

Spring AI 通过两个专用模块，将容器化服务连接的复杂度降到最低：

核心原则 ：只需添加对应依赖，Spring Boot 自动配置会探测运行中的容器并建立连接，开发者无需手写任何连接参数。