很多教程一上来就写 AI 接口。

但我这次想先把工程地基搭稳：项目能启动，依赖能加载，配置能管理。

这一篇会把“创建 Spring Boot 项目”和“接入 Spring AI 依赖”放在一起完成。

答案先说

这一篇只做一件事：创建一个 Spring Boot 项目，并接入 Spring AI 依赖和模型基础配置。

读完并跟着做完后，项目会有一个明确的新增能力，而不是只停留在概念介绍。

上一篇做到哪了

第 0 篇我们确定了学习路线：围绕一个企业知识库问答助手，逐步学习 Spring AI。

这篇会在上一节的基础上继续往前走。

这张图就是本篇的主线。先把流程看清楚，再进入代码会轻松很多。

核心概念

这一篇先不急着调用模型。

Spring AI 的使用体验很像其他 Spring 生态组件：依赖、配置、Bean 注入、Controller、Service。先把这些基础做好，后面的 ChatClient、RAG、Tool Calling 才能顺着往下走。

开始实操

1. 创建 Spring Boot 项目

建议使用 Spring Initializr：

• Project：Maven
• Language：Java
• Spring Boot：3.5.x
• Java：21
• Dependencies：Spring Web

2. 添加一个测试接口

@RestController
@RequestMapping("/hello")
public class HelloController {

    @GetMapping
    public String hello() {
        return "Spring AI Study";
    }
}

3. 引入 Spring AI BOM

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-bom</artifactId>
            <version>${spring-ai.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

4. 添加模型依赖

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>

5. 添加模型配置

spring:
  ai:
    openai:
      api-key: ${OPENAI_API_KEY}
      base-url: ${OPENAI_BASE_URL}
      chat:
        options:
          model: ${OPENAI_MODEL}

运行效果

curl http://localhost:8080/hello

预期返回：

Spring AI Study

然后启动项目，确认 Spring AI 依赖加载没有报错：

mvn spring-boot:run

踩坑记录

这里先列出本篇最可能遇到的问题，后面实操时再补充真实截图和日志。

• JDK 版本和 Spring Boot 版本不匹配
• Spring AI 版本和 Spring Boot 版本不兼容
• API Key 直接写在配置文件里，后面不好管理
• 兼容模型的 base-url 写错
• Maven 下载依赖失败

项目里怎么理解

这一篇完成的是工程起点。项目还没有真正调用模型，但已经具备了后续接入 AI 能力的基础条件。

本篇小结

这一篇完成的不是一个孤立知识点，而是让项目继续向最终的“企业知识库问答助手”靠近了一步。

下一篇预告

下一篇我们会写第一个 AI 聊天接口，并顺手用 ChatClient 重构成更适合扩展的写法。