Spring AI BOM 介绍：让你的 Spring Boot AI 开发更简单 – wiki基地

作者： /

这是一篇为您准备的关于 Spring AI BOM 的技术文章。它详细介绍了概念、优势以及如何在实际项目中配置（Maven 和 Gradle）。

Spring AI BOM 介绍：让你的 Spring Boot AI 开发更简单

在生成式 AI (GenAI) 爆发的今天，Java 开发者都在寻找能够无缝集成 LLM（大语言模型）到现有企业级应用中的方案。Spring AI 应运而生，它为 Spring Boot 应用提供了一套标准的 AI 开发接口。

然而，随着 Spring AI 生态的快速扩张（支持 OpenAI、Azure、Bedrock、Ollama 等多种模型，以及各种 Vector Store），依赖管理变得越来越复杂。这时，Spring AI BOM (Bill of Materials) 就成为了开发者的救星。

本文将详细介绍 Spring AI BOM 的作用，以及如何利用它简化你的开发流程。

1. 什么是 BOM (Bill of Materials)？

在 Maven 或 Gradle 的世界里，BOM（物料清单）是一个特殊的 POM 文件。它不包含具体的代码，而是定义了一组库的版本映射关系。

简单来说，Spring AI BOM 就是一份清单，它告诉你的项目：“当使用 Spring AI 的任何组件（如 Core、OpenAI Starter、Redis Vector Store 等）时，请默认使用这个特定的版本。”

2. 为什么要使用 Spring AI BOM？

如果不使用 BOM，你可能会在 pom.xml 中写出这样的代码：

“`xml


org.springframework.ai
spring-ai-core
1.0.0-M1


org.springframework.ai
spring-ai-openai-spring-boot-starter
1.0.0-M1

“`

这种做法有几个明显的痛点：
1. 版本冲突（Dependency Hell）： 如果你手动将 core 升级到了 1.0.0-M2，却忘记升级 openai starter，应用可能会因为类找不到或方法签名不匹配而崩溃。
2. 升级繁琐： 每次发布新版本，你都需要手动修改每一个依赖的版本号。
3. 配置冗余： 你的 pom.xml 会变得臃肿且难以维护。

使用 BOM 后的优势：
* 统一版本管理： 只需修改 BOM 的版本号，所有相关组件都会自动对齐到兼容的版本。
* 简化配置： 引入具体依赖时，不再需要写 <version> 标签。
* 保证兼容性： Spring 团队已经测试过 BOM 中定义的版本组合，确保它们能在一起正常工作。

3. 如何在项目中使用 Spring AI BOM

场景一：使用 Maven

在你的 pom.xml 文件中，你需要进行两步操作。

第一步：在 <dependencyManagement> 中引入 BOM

xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.0.0-M1</version> <!-- 请根据官网替换为最新版本 -->
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

第二步：在 <dependencies> 中添加具体模块（无需版本号）

现在，当你想使用 OpenAI 的功能时，只需要引入 Starter 即可：

“`xml



org.springframework.ai
spring-ai-openai-spring-boot-starter

<!-- 如果还需要向量数据库，同样无需指定版本 -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-pgvector-store-spring-boot-starter</artifactId>
</dependency>


“`

场景二：使用 Gradle

在 build.gradle 中，利用 Gradle 的 platform 机制来实现 BOM 管理。

“`groovy
dependencies {
// 1. 引入 BOM
implementation platform(“org.springframework.ai:spring-ai-bom:1.0.0-M1”)

// 2. 引入具体模块（无需版本号）
implementation "org.springframework.ai:spring-ai-openai-spring-boot-starter"
implementation "org.springframework.ai:spring-ai-neo4j-store-spring-boot-starter"

}
“`

4. 特别注意：关于 Maven 仓库配置

由于 Spring AI 目前（截至 2024/2025）仍在快速迭代中，很多新特性可能发布在 Milestone (里程碑) 或 Snapshot (快照) 仓库中，而不在 Maven Central 中央仓库。

如果你使用的是 Milestone 或 Snapshot 版本，必须在 pom.xml 或 build.gradle 中添加 Spring 的专用仓库：

Maven 配置示例：

xml
<repositories>
<repository>
<id>spring-milestones</id>
<name>Spring Milestones</name>
<url>https://repo.spring.io/milestone</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
<repository>
<id>spring-snapshots</id>
<name>Spring Snapshots</name>
<url>https://repo.spring.io/snapshot</url>
<releases>
<enabled>false</enabled>
</releases>
</repository>
</repositories>

5. 总结

Spring AI BOM 是开发 Spring Boot AI 应用的基石。它不仅仅是一个依赖配置文件，更是 Spring 生态“约定优于配置”理念的体现。

核心价值一句话总结：

Spring AI BOM 让你不再关注繁琐的依赖版本号，从而将精力集中在 Prompt 设计、RAG 架构搭建和业务逻辑实现上。

如果你的下一个项目涉及 Java 与 AI 的融合，请务必从配置 Spring AI BOM 开始！

滚动至顶部