JDK 8 接大模型:Spring AI 最低只到 Boot 3.5,官方 SDK 还能救
Spring AI 兼容表只有 Boot 3.5/4.1/4.2,LangChain4j 编译基线是 Java 17。JDK 8 + Boot 2.7 的老系统接大模型,只剩 openai-java、ai4j 和手写 HTTP 三条路。给出最小接入代码、BOM 压回 Jackson 2.13.5 的修法与 9 条报错急救。
如果你手上的系统还是 JDK 8 + Spring Boot 2.7,搜「Java 接大模型」搜到的第一条教程多半让你加 spring-ai-starter。加完大概率是启动报错,或者依赖树里一串 jakarta 冲突——Spring AI 的兼容表里,没有 Spring Boot 2 这一行。
这不是配置问题,是字节码问题。LangChain4j 1.24.0 的编译基线是 Java 17(class 文件版本 61),JDK 8 连类都加载不了;Spring AI 2.1.0 对应 Boot 4.2.x,往回退到 1.1.x 也只到 Boot 3.5.x。
但老系统不用等死。OpenAI 官方 Java SDK(com.openai:openai-java)的版本策略写得很明确:framework-neutral 构件「保留 Java 8 直到 v4」。这条路能跑,代价是你要自己处理 Boot 2.7 BOM 的三个版本压制。下面是按这条路线整理的最小接入与排坑清单,版本号都在 2026-11-20 核对过。
先看清墙在哪:四个框架的编译基线与 Boot 兼容线
四个最常被推荐的选择,硬门槛完全不同。先查「能不能加载」,比盲目试依赖省时间。
| 框架 / SDK | 最新版本 | 编译基线 | 官方支持线 | JDK 8 能否加载 |
|---|---|---|---|---|
| Spring AI | 2.1.0(11-20) | Java 17+ | 2.1.x→Boot 4.2.x;2.0.x→4.1.x;1.1.x→3.5.x | 不能,且没有 Boot 2 线 |
| LangChain4j | 1.24.0(11-18) | Java 17(pom 的 java.version=17) | 不绑 Boot,但字节码是 61 | 不能 |
| openai-java | 4.111.0 | Java 8(官方版本策略) | 无官方 starter(见下) | 能 |
| ai4j | 2.8.1 | Java 8(source/target=8) | 提供 Spring Boot starter | 能 |

LangChain4j 还有个容易忽略的规则:官方每次是「1.24.0 + 1.24.0-beta34」成对发布,agentic、mcp、guardrails 这些模块只发 beta。核心包与 beta 包必须同一次发版,1.24.0 配 1.23.0-beta33 编译能过,运行时才报 NoSuchMethodError。
也别想着「降级到支持 JDK 8 的旧版」。LangChain4j 0.36.2(2024-11-21)的 parent pom 里 java.version 已经是 17。这条线从 0.36 起就没给 JDK 8 留门。
第一条路:openai-java 4.111.0 的最小接入(别引 starter)
先说最容易踩的一脚:网上不少教程让你引 openai-java-spring-boot-starter。这个构件在 4.45.0 之后就不发了。
OpenAI 的 ADR 写得很直白:starter 面向 Spring Boot 2.7,2026-07-27 起 EOL,4.45.0 是最后一个受支持、受测试、已发布的版本,源码已经从主分支移除。你在 4.111.0 的工程里声明 starter 4.111.0,Maven 只会回你 Could not find artifact。
正确姿势是自己声明一个 OpenAIClient Bean。依赖只有一个:
<dependency>
<groupId>com.openai</groupId>
<artifactId>openai-java</artifactId>
<version>4.111.0</version>
</dependency>
Bean 和调用。接 DeepSeek、通义、豆包、vLLM 这类 OpenAI 兼容端点时,baseUrl 和 model(String) 都有重载,不用改 SDK 源码:
@Configuration
public class LlmConfig {
@Bean(destroyMethod = "close")
public OpenAIClient openAIClient(
@Value("${llm.api-key}") String apiKey,
@Value("${llm.base-url}") String baseUrl) {
return OpenAIOkHttpClient.builder()
.apiKey(apiKey)
.baseUrl(baseUrl) // 例如 https://api.deepseek.com/v1
.build();
}
}
@Service
public class SummaryService {
private final OpenAIClient client;
public SummaryService(OpenAIClient client) { this.client = client; }
public String summarize(String text) {
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model("deepseek-chat") // 兼容端点直接给字符串
.addSystemMessage("你是客服质检助手,只输出结论。")
.addUserMessage(text)
.build();
ChatCompletion resp = client.chat().completions().create(params);
return resp.choices().get(0).message().content().orElse("");
}
}
流式也不需要 JDK 11 的 java.net.http:SDK 走 OkHttp 的 SSE,createStreaming 返回 StreamResponse,JDK 8 的 try-with-resources 就能用。
try (StreamResponse<ChatCompletionChunk> stream =
client.chat().completions().createStreaming(params)) {
stream.stream().forEach(chunk ->
chunk.choices().forEach(c ->
c.delta().content().ifPresent(System.out::print)));
}
注意 @Bean(destroyMethod = "close")。这个客户端自己持有连接池和线程池,官方 README 明确说「一个应用不要建多个 client」。Spring 单例正合适,别在方法里 new。
真正卡人的不是 JDK,是 Boot 2.7 的 BOM 把三个依赖压回老版本
依赖加进去、代码写完,启动时大概率不是编译错误,而是运行期 NoSuchMethodError。原因不在 SDK,在你父 POM 里的 spring-boot-dependencies。
Maven 的 dependencyManagement 优先级高于传递依赖自带的版本。Boot 2.7.18 管着下面三个属性,而 openai-java 4.111.0 是按更高版本编译的。
| 依赖 | Boot 2.7.18 管理值 | openai-java 4.111.0 要求 | 被压回后的典型症状 |
|---|---|---|---|
| jackson-bom | 2.13.5 | 2.18.9(core / databind / annotations / jdk8 / jsr310 / kotlin 六个构件) | 启动或首次序列化时 NoSuchMethodError,栈顶落在 com.openai.core 的 JSON 处理 |
| kotlin-stdlib / kotlin-reflect | 1.6.21 | 1.8.0 / 1.8.20 | NoSuchMethodError,或 NoClassDefFoundError: kotlin/... |
| okhttp(okhttp-bom) | 4.9.3 | 4.12.0 | 发请求时才炸,栈里能看到 okhttp3 |
| spring-boot-starter 构件 | 无 | 4.45.0 之后不再发布 | Could not find artifact |

一条 mvn 命令确认你中的是哪一枪
别猜,先把实际解析到的版本打出来:
mvn -q dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind,org.jetbrains.kotlin:kotlin-stdlib,com.squareup.okhttp3:okhttp
输出里的版本号低于上表右列,就是被 BOM 压了。不要用 exclude 一个个拆——你拆掉的是 SDK 真正需要的那一份,最后还得手工补回来,依赖树只会更乱。
修法:顶掉三个属性,而不是改依赖版本
Boot 2.7 的父 POM 把这三项都做成了可覆盖属性,直接在 <properties> 里顶掉最省事,也不会破坏 starter 的自动配置顺序:
<properties>
<java.version>1.8</java.version>
<jackson-bom.version>2.18.9</jackson-bom.version>
<kotlin.version>1.8.20</kotlin.version>
<okhttp.version>4.12.0</okhttp.version>
</properties>
没继承 spring-boot-starter-parent(比如用公司自己的父 POM)的,就在 dependencyManagement 里显式 import jackson-bom 和 okhttp-bom,放在 spring-boot-dependencies 之后——同层级后导入的赢。
升级 Jackson 会牵动 Spring MVC。2.13 到 2.18 跨了五个小版本,ObjectMapper的默认行为、日期序列化、未知字段处理都可能有变化。改完必须回归一遍对外接口的 JSON 输出,尤其是用了@JsonFormat和自定义Serializer的地方。
第二条路:ai4j 2.8.1,JDK 8 原生,自带 RAG 与 MCP
如果你要的不只是「调一次模型」,而是工具调用、RAG、MCP 这一整套,openai-java 就太素了。国产的 ai4j 是少数把 JDK 8 写进编译配置的项目:POM 里 maven.compiler.source/target 都是 8,README 直接标 JDK 8+。
<dependency>
<groupId>io.github.lnyo-cly</groupId>
<artifactId>ai4j</artifactId>
<version>2.8.1</version>
</dependency>
OpenAiConfig cfg = new OpenAiConfig();
cfg.setApiKey(System.getenv("OPENAI_API_KEY"));
Configuration configuration = new Configuration();
configuration.setOpenAiConfig(cfg);
AiService aiService = new AiService(configuration);
IChatService chat = aiService.getChatService(PlatformType.OPENAI);
ChatCompletion req = ChatCompletion.builder()
.model("gpt-4o-mini")
.message(ChatMessage.withUser("用一句话介绍 ai4j"))
.build();
System.out.println(chat.chatCompletion(req)
.getChoices().get(0).getMessage().getContent().getText());
换 DeepSeek、通义、Ollama 只改 PlatformType 和对应的 Config,调用代码不动。
但 BOM 压制一样逃不掉。ai4j 2.8.1 的 POM 声明了 Jackson 2.16.0、OkHttp 4.12.0,在 Boot 2.7 父 POM 下同样会被压回 2.13.5 / 4.9.3。上面那三个属性照抄一遍就行,不用改。
它的代价也要说清楚:依赖比 openai-java 重得多,Tika、Guava、fastjson2 都在传递链里。一个只做文本摘要的服务引它,包体积会翻几倍。功能密度换体积,按需选。
第三条路:不引任何库,HttpURLConnection 手写四十行
如果整个系统只有一个「把工单内容分类」的调用点,为它引一个 SDK 再加三个版本覆盖,维护成本不划算。JDK 8 没有 java.net.http,但自带的 HttpURLConnection 一直能用,而且不新增任何一个 jar:
URL url = new URL(baseUrl + "/chat/completions");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setConnectTimeout(10000);
conn.setReadTimeout(120000); // 默认 0,等于永不超时
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("Authorization", "Bearer " + apiKey);
try (OutputStream os = conn.getOutputStream()) {
os.write(objectMapper.writeValueAsBytes(requestBody)); // 别手工拼串
}
int code = conn.getResponseCode();
InputStream in = (code >= 200 && code < 300)
? conn.getInputStream() : conn.getErrorStream();
ByteArrayOutputStream buf = new ByteArrayOutputStream();
byte[] b = new byte[8192];
for (int n; (n = in.read(b)) != -1; ) {
buf.write(b, 0, n);
}
String body = new String(buf.toByteArray(), StandardCharsets.UTF_8);
三个必须自己处理的点:JSON 转义(手工拼串最容易在用户输入带引号时炸)、读超时(HttpURLConnection 默认 0,等于永不超时,长文生成会把线程挂死)、重试(429 要退避,别原地重试)。
要流式就得自己解析 text/event-stream:按行读、跳过 data: [DONE]、只取 data: 后面的 JSON。嫌麻烦可以换成 OkHttp 4.12 配 okhttp-sse,但那就回到了版本覆盖的问题。
三条路怎么选:看你能不能动 BOM
| 你的现状 | 推荐 | 代价 |
|---|---|---|
| 只调用模型,能改父 POM 属性 | openai-java 4.111.0 | 要顶 Jackson / Kotlin / OkHttp 三个版本,Jackson 升级需回归接口 |
| 要工具调用、RAG、MCP,团队接受重依赖 | ai4j 2.8.1 | 传递依赖多,同样要顶三个版本 |
| 只有一个调用点,不想动 BOM | HttpURLConnection 手写 | 转义、超时、重试、流式全自己写 |
| 能升到 JDK 17 + Boot 3.5 | Spring AI 1.1.x | 要改 javax→jakarta,工作量在迁移不在 AI |
| 能升到 JDK 17+ 且 Boot 4.x | Spring AI 2.x | Boot 4 生态还在补,第三方 starter 要逐个验 |
常见翻车报错与急救清单
| 报错 / 现象 | 原因 | 处理 |
|---|---|---|
| UnsupportedClassVersionError,class file version 61.0 | 在 JDK 8/11 上引了 LangChain4j 1.x | 改走 openai-java 或 ai4j;降版本没用,0.36.2 已是 17 |
| Could not find artifact com.openai:openai-java-spring-boot-starter | starter 在 4.45.0 后停发 | 删掉 starter,手写 OpenAIClient Bean |
| NoSuchMethodError,栈顶在 com.openai.core | Jackson 被压回 2.13.5 | 顶 jackson-bom.version=2.18.9 |
| NoSuchMethodError: kotlin.* 或 NoClassDefFoundError: kotlin/... | kotlin-stdlib 被压回 1.6.21 | 顶 kotlin.version=1.8.20 |
| 请求阶段 NoSuchMethodError,栈里有 okhttp3 | OkHttp 被压回 4.9.3 | 顶 okhttp.version=4.12.0 |
| PKIX path building failed / unable to find valid certification path | 内网代理换了证书,JDK 8 的 cacerts 里没有企业根证书 | keytool 导入根证书,或启动参数指定 trustStore |
| SocketTimeoutException: timeout,只在长回答出现 | 读超时没设(HttpURLConnection 默认 0),或沿用 OkHttp 的 10 秒默认值 | 显式设 60–120 秒 |
| 偶发 JsonParseException,输入含引号或换行 | 手工拼 JSON 没转义 | 用 ObjectMapper 序列化请求体,别拼字符串 |
| 401 和 429 分不清 | 401 多是 key 错或 baseUrl 少了 /v1;429 是限流 | 先用 curl 打同一个 baseUrl 验证,再排查 SDK 重试 |
三个边界:什么情况别硬撑 JDK 8
- 要吃新模型的原生能力,别硬撑。结构化输出、内置工具、reasoning 字段通常先在 Python / TS 落地,Java 侧要等适配;国产模型的私有参数仍得自己发原始 JSON。
- 团队要长期做 Agent 平台,别硬撑。观测、评估、trace 这套东西 Java 侧本来就薄,JDK 8 更用不上虚拟线程去扛「一人一 Agent」的并发模型。这种场景该把 JDK 17/21 迁移排上日程。
- 合规要求能自证依赖来源,别硬撑。Boot 2.7 的 OSS 支持 2023-11 就结束了,openai-java 的 starter 也因此 EOL。安全扫描报出 CVE 时你得自己 backport,这是维护责任问题。
JDK 8 接大模型不是「能不能」的问题,是「绕不绕得开 BOM」的问题。三条路里,openai-java 最轻、ai4j 最全、OkHttp 最省依赖,共同点是都要自己管版本,没有一条能像 Spring AI 那样一行 starter 搞定。
这也解释了为什么这类教程少:写的人默认你已经在 JDK 17 上。你如果在 JDK 8 上跑通过某条路,或卡在某条报错上,把 mvn dependency:tree 的片段贴到评论区,我帮你看是哪一层被压了。
站内相关:《AgentScope Durable 避坑实录:Java 企业 Agent 断线续跑的最小接入》——那篇讲状态恢复,这篇讲版本与依赖,正好互补。
登录后可点赞、收藏与反馈。