当前位置： 首页 > news >正文

Java新手5分钟接AI：Spring AI Alibaba实战

news 2026/5/1 18:04:51

Java新手5分钟接AI：Spring AI Alibaba实战

一、你是不是也觉得Java接AI很难？

“AI这么火，我想在Java项目里用大模型，但不知道从哪开始。”

这话说出了多少Java开发者的心声。

看看隔壁Python，OpenAI SDK一行代码就能调用GPT。再看看Java，什么Spring AI、什么阿里Spring AI Alibaba、什么DeepSeek接入…文档一大堆，版本号满天飞，光是选型就让人头大。

更让人崩溃的是网上的教程。要么是"Maven配置+YAML"就没了，代码呢？要么是上来就讲RAG、向量数据库、Agent架构——我只想调用个AI对话而已，用得着这么复杂吗？

我懂这种感觉。去年我第一次尝试在Spring Boot项目里接入AI，光是解决版本冲突就折腾了两天。

但今天我要告诉你一个真相：Java接AI，其实5分钟就能跑通第一个对话。

二、真相：5分钟跑通AI对话

Spring AI在2025年发布了1.0正式版，不再是那个三天两头改API的预览版了。

更重要的是，阿里推出了Spring AI Alibaba，专门针对国内开发者优化。支持通义千问、DeepSeek等国产大模型，开箱即用。

你不需要：

  • 不需要懂AI原理
  • 不需要学Python
  • 不需要配置复杂的模型推理环境
  • 不需要买显卡

你只需要：

  • JDK 17
  • Maven
  • 一个IDE（IDEA或Eclipse都行）
  • 一个DeepSeek账号（新用户送10元额度）

就这些。下面我们直接上代码，复制就能跑。

三、准备工作：三件套就够了

3.1 确认JDK版本

打开终端，运行：

java-version

看到17或更高版本就行。如果还是JDK 8或11，去Oracle官网或者用SDKMAN装一个JDK 17。

# 用SDKMAN安装JDK 17curl-s"https://get.sdkman.io"|bashsdkinstalljava17.0.9-tem

3.2 确认Maven

mvn-version

能输出版本信息就行。没有的话去官网下载，解压，配环境变量。

3.3 获取DeepSeek API Key

这是唯一需要"操作"的一步：

  1. 打开 https://platform.deepseek.com/
  2. 注册账号（支持微信登录）
  3. 充值10元（够你玩很久）
  4. 进入API Keys页面，创建一个Key

重要：Key只在创建时显示一次，马上复制保存。丢了只能重新创建。

四、实战：Spring AI Alibaba接DeepSeek

Step 1：创建项目

用IDEA新建一个Maven项目，或者直接在现有项目里加依赖。

完整pom.xml：

<?xml version="1.0" encoding="UTF-8"?><projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.4.5</version><relativePath/></parent><groupId>com.example</groupId><artifactId>spring-ai-demo</artifactId><version>1.0.0</version><name>Spring AI DeepSeek Demo</name><properties><java.version>17</java.version><spring-ai.version>1.0.0</spring-ai.version><spring-ai-alibaba.version>1.0.0.2</spring-ai-alibaba.version></properties><dependencies><!-- Spring Boot Web --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- Spring AI OpenAI Starter（兼容DeepSeek） --><dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-starter-model-openai</artifactId></dependency><!-- Lombok（可选，简化代码） --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

关键点说明：

  • spring-boot-starter-parent3.4.5：Spring AI要求Spring Boot 3.2以上
  • spring-ai-starter-model-openai：Spring AI官方OpenAI启动器，兼容DeepSeek
  • JDK版本必须是17或更高

Step 2：配置API Key

在src/main/resources/application.yml中添加：

spring:application:name:spring-ai-demoai:openai:# API Key从环境变量读取，不要硬编码！api-key:${DEEPSEEK_API_KEY}# DeepSeek的API地址（不是OpenAI的！）base-url:https://api.deepseek.comchat:options:# 使用的模型model:deepseek-chat# 温度参数，0-2，越高越随机temperature:0.7

为什么用环境变量？

安全。代码会上传到Git仓库，API Key硬编码在里面等于把钥匙放在门口。万一泄露，别人能用你的额度刷爆账单。

设置环境变量：

macOS/Linux（终端）：

exportDEEPSEEK_API_KEY="你的API Key"

Windows（CMD）：

set DEEPSEEK_API_KEY=你的API Key

Windows（PowerShell）：

$env:DEEPSEEK_API_KEY="你的API Key"

或者在IDEA里配置：Run → Edit Configurations → Environment variables，添加DEEPSEEK_API_KEY。

Step 3：写第一个AI对话

创建主类src/main/java/com/example/AiDemoApplication.java：

packagecom.example;importorg.springframework.ai.chat.client.ChatClient;importorg.springframework.boot.CommandLineRunner;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.context.annotation.Bean;@SpringBootApplicationpublicclassAiDemoApplication{publicstaticvoidmain(String[]args){SpringApplication.run(AiDemoApplication.class,args);}@BeanCommandLineRunnerdemo(ChatClient.BuilderchatClientBuilder){returnargs->{// 构建ChatClientChatClientchatClient=chatClientBuilder.build();// 发送消息并获取回复Stringresponse=chatClient.prompt("你好，请用一句话介绍Spring框架").call().content();System.out.println("AI回复："+response);};}}

代码解读：

  1. ChatClient.Builder由Spring AI Alibaba自动注入，已经配置好DeepSeek连接
  2. .prompt("你的问题")设置用户消息
  3. .call()执行同步调用
  4. .content()提取纯文本回复

Step 4：运行测试

在项目根目录执行：

mvn spring-boot:run

等几秒钟，控制台会输出类似这样的内容：

AI回复：Spring是一个开源的Java企业级开发框架，提供了依赖注入、面向切面编程、事务管理等核心功能，帮助开发者快速构建可维护的企业级应用。

恭喜，你已经成功在Java里调用AI了！

实际效果：

  • 启动速度：约3秒
  • 首次响应：约1-2秒
  • Token消耗：约50 tokens（问+答）
  • 费用：约0.001元

是的，这一次对话的成本不到一分钱。

五、进阶：做成API服务

实际项目中，你需要把AI能力暴露成HTTP接口。我们加一个Controller。

创建src/main/java/com/example/controller/ChatController.java：

packagecom.example.controller;importorg.springframework.ai.chat.client.ChatClient;importorg.springframework.web.bind.annotation.*;@RestController@RequestMapping("/api/chat")publicclassChatController{privatefinalChatClientchatClient;publicChatController(ChatClient.BuilderchatClientBuilder){this.chatClient=chatClientBuilder.defaultSystem("你是一个专业的技术助手，回答简洁准确。").build();}@PostMappingpublicStringchat(@RequestBodyStringmessage){returnchatClient.prompt(message).call().content();}@GetMapping("/stream")publicStringstreamChat(@RequestParamStringmessage){StringBuilderresult=newStringBuilder();chatClient.prompt(message).stream().content().doOnNext(result::append).blockLast();returnresult.toString();}}

测试接口：

curl-XPOST http://localhost:8080/api/chat\-H"Content-Type: text/plain"\-d"Java和Python的区别是什么？"

关键改进：

  1. defaultSystem()设置系统提示词，定义AI的角色和行为
  2. 提供了两个接口：同步/api/chat和流式/api/chat/stream
  3. 真正的服务端应用，可以被前端或其他服务调用

六、踩坑：我遇到的3个问题

问题1：版本兼容性地狱

现象：启动报错，NoSuchMethodError或ClassNotFoundException。

原因：Spring AI 1.0正式版和之前的Milestone版本API差异很大。很多教程还在用0.8或1.0-M3的写法。

解决：

统一使用正式版：

  • Spring AI 1.0.0
  • Spring AI Alibaba 1.0.0.2
  • Spring Boot 3.4.5

不要混用不同版本的依赖。

问题2：API Key配置错误

现象：启动成功，但调用时报401 Unauthorized。

原因排查：

  1. 环境变量没设置或设置错误
  2. YAML配置里直接写了Key，但格式有问题（比如多了空格）
  3. DeepSeek账户余额不足

正确做法：

# 正确api-key:${DEEPSEEK_API_KEY}# 错误（直接写Key，且容易泄露）api-key:sk-xxxxxxxxxxxxxx# 错误（环境变量名写错）api-key:${DEEPSEEK_KEY}

验证环境变量是否生效：

@SpringBootApplicationpublicclassAiDemoApplication{publicstaticvoidmain(String[]args){System.out.println("API Key: "+System.getenv("DEEPSEEK_API_KEY"));SpringApplication.run(AiDemoApplication.class,args);}}

问题3：DeepSeek base-url写错

现象：连接超时或404。

原因：Spring AI Alibaba默认配置的是通义千问的地址，需要手动改成DeepSeek的。

正确配置：

spring:ai:openai:base-url:https://api.deepseek.com# 必须写这个，不是OpenAI的地址

常见错误：

# 错误1：用了OpenAI的地址base-url:https://api.openai.com/v1# 错误2：多写了/v1base-url:https://api.deepseek.com/v1# 错误3：协议写错base-url:http://api.deepseek.com# 应该是https

DeepSeek的API地址是https://api.deepseek.com，不需要/v1后缀。

七、总结：Java开发者的AI上手路线图

5分钟跑通了，然后呢？

第一阶段：熟练使用ChatClient

  • 掌握prompt()、call()、stream()的用法
  • 学会设置系统提示词控制AI行为
  • 尝试不同的temperature参数，观察输出差异

第二阶段：接入业务场景

  • 客服机器人：结合知识库回答用户问题
  • 文档助手：总结、翻译、生成报告
  • 代码助手：代码审查、生成注释、重构建议

第三阶段：进阶能力

  • Function Calling：让AI调用你的Java方法
  • RAG：检索增强生成，让AI基于你的私有数据回答
  • Agent：多步骤任务编排，让AI自己规划执行

关键认知：

Java接AI不难，难的是选对工具、避开坑。

Spring AI Alibaba就是那个对的选择——官方维护、国产模型友好、API简洁。

不要被网上那些"AI从入门到放弃"的复杂教程吓到。先跑通第一个对话，再一步步深入。

毕竟，每个AI专家都是从调用一次API开始的。

本文涉及的所有代码已验证可运行，环境版本：

  • JDK 17
  • Spring Boot 3.4.5
  • Spring AI 1.0.0
  • Spring AI Alibaba 1.0.0.2
  • DeepSeek API（deepseek-chat模型）

有任何问题欢迎留言讨论。

http://www.jsqmd.com/news/733107/

相关文章：

  • 体验Taotoken多模型聚合路由带来的高可用性与低延迟响应
  • Windows系统优化终极指南：Chris Titus Tech WinUtil完全教程
  • Windows用户必看：巧用‘文档’属性，彻底告别C盘爆满（微信/QQ/软件缓存全搞定）
  • 学了CS61B后，我的LeetCode刷题效率翻倍了：Josh Hug教我的数据结构实战心法
  • 期货量化参数管理实战：防过拟合的滚动验证与版本追踪
  • 10分钟训练专业级AI音色：RVC变声器终极指南
  • 如何高效使用Harepacker-resurrected打造个性化MapleStory世界：终极指南
  • Uni-Mol技术深度解析：3D分子表示学习的架构设计与创新突破
  • Android音频终极优化指南：用Audio-Misc-Settings模块告别音质损耗
  • Matlab Simulink变压器饱和模型与励磁涌流仿真：剩磁、饱和磁通特性、磁滞特性以及参...
  • 从热电偶到加速度计：搞懂传感器信号类型，是选单端还是差分接线的第一步
  • 30-120W快充/适配器SiC反激控制器LP8841SC 技术参数与设计应用解析
  • 20262
  • 如何免费强力修复损坏的MP4视频文件：完整终极指南
  • Win7资源管理器FTP链接总跳浏览器？一个注册表文件帮你5分钟搞定
  • Windows性能调优实战：用PerfView揪出.NET应用里的“慢”方法（附SpeedScope火焰图分析）
  • IMO/IOI奖牌得主18000人追踪：1500倍概率成亿万富翁
  • GlyphPrinter框架：基于区域偏好的智能文本渲染技术
  • 5步掌握：如何用本地图片搜索引擎管理百万级图库
  • VSCode 2026 AI调试器突然禁用？3步绕过企业策略限制，解锁5种被隐藏的智能纠错模式（含TypeScript/Python/Rust全栈支持）
  • 2026年经营指标分析平台推荐：指标管理、口径统一与决策支持全解析 - 科技焦点
  • 软件开发方法之 V 模型
  • LangChain父文档检索器实战：用小米汽车和台积电文档，手把手教你解决RAG检索的‘块大小’难题
  • 解决NuGet源授权问题
  • 别再只盯着MOS了！聊聊语音合成项目里，MCD和STOI这两个客观指标到底该怎么用（附Python避坑指南）
  • 【2026年版｜建议收藏】程序员小白大模型转型全指南，轻松拿捏AI技术红利
  • FanControl终极指南：3分钟搞定Windows风扇控制，告别电脑噪音烦恼
  • 别再傻傻问‘这网站用什么建的’了！手把手教你用Wappalyzer插件和几个在线工具，5分钟识别网站技术栈
  • TGV孔内铜柱怎么填？填铜工艺决定最终良率，96%良率是怎么做到的
  • 香蕉派开源社区联合进迭进空重磅打造： BPI‑SM10(K3-Com260) 和 K3 Pico‑ITX 计算机将于5月11日全球发货