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

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

news 2026/7/2 13:17:53

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.cnnetsun.cn/news/2178023.html

相关文章：

  • 终极游戏音频解密指南：acbDecrypter一键转换ACB/HCA/ADX到WAV
  • 别再只点灯了！用Arduino Uno的PWM引脚做个呼吸灯，顺便搞懂analogWrite()
  • 2026深圳个人写真工作室真实测评排行TOP榜
  • 如何免费强力修复损坏的MP4视频文件：完整终极指南
  • Windows性能调优实战：用PerfView揪出.NET应用里的“慢”方法（附SpeedScope火焰图分析）
  • 软件开发方法之 V 模型
  • 别再手动填Token了！Postman环境变量+脚本自动搞定CSRF认证（附完整代码）
  • TestDisk PhotoRec：免费开源数据恢复终极指南，从分区修复到文件拯救
  • 2026年5月阿里云Hermes Agent/OpenClaw集成教程+百炼token Plan速览全攻略
  • springboot+vue3的社区儿童玩具交易系统
  • 手把手教你用Python+OpenCV模拟‘找色’自瞄原理（仅供学习反作弊）
  • MuJoCo物理仿真中物体滑动问题的终极解决方案：从参数调优到高级建模技术
  • PDF.js 实战：除了隐藏工具栏，这几种定制化需求你也能轻松搞定
  • PCL2启动器下载功能深度解析：如何高效获取Minecraft游戏资源
  • Nginx 为什么强：不只是 epoll 和零拷贝，而是一整套高并发工程设计
  • 别再死记硬背了！用这5个ChatGPT提示词，轻松搞定大学英语写作课作业
  • 从VGG到ResNet：为什么加了这几条‘跳线’，模型性能就起飞了？
  • 零成本打造创维E900V22C专业4K媒体中心：CoreELEC终极改造指南
  • MATLAB滤波器设计的两种归宿：生成MATLAB滤波函数 vs. 导出Xilinx .coe文件，你选对了吗？
  • 从玩具到工具：用74HC595和数码管为你的Arduino项目做个‘状态监视器’
  • 内容创作平台集成 Taotoken 实现智能写作助手的多模型后备方案
  • 轻量化AI边缘计算节点搭建：用RDK X3模组+微雪Nano载板打造30g以内的计算单元
  • Lua 5.1 字节码逆向工程：如何高效恢复被编译的Lua脚本？
  • 跨浏览器书签怎么在多设备间同步？云加密同步、冲突合并与 VertiTab 完整指南
  • SOCD Cleaner终极指南：彻底解决游戏键盘输入冲突的4种模式
  • 抖音视频下载终极指南：开源工具高效批量下载完整教程
  • 视频字幕提取终极指南：3步实现本地硬字幕精准识别
  • 第3篇：数据的运算——让数据动起来 Rust中文编程
  • 2025届毕业生推荐的六大AI科研工具解析与推荐
  • 025、记忆系统：短期记忆与长期记忆