个人学习小站 SIGNAL DESK 2026
LIVE --:--:-- 反馈
资讯 人工智能 OpenAI SDK 版本策略/ADR、Spring AI README、LangChain4j 发布页与 pom、Boot 2.7.18 BOM

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 条报错急救。

2026年11月21日 2 小时前 作者 站长 约 9 分钟 15 阅读

如果你手上的系统还是 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 AI2.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 线
LangChain4j1.24.0(11-18)Java 17(pom 的 java.version=17)不绑 Boot,但字节码是 61不能
openai-java4.111.0Java 8(官方版本策略)无官方 starter(见下)能
ai4j2.8.1Java 8(source/target=8)提供 Spring Boot starter能

JDK 8 下四个 Java 框架的可加载性对比:Spring AI 与 LangChain4j 不可用,openai-java 与 ai4j 可用

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-bom2.13.52.18.9(core / databind / annotations / jdk8 / jsr310 / kotlin 六个构件)启动或首次序列化时 NoSuchMethodError,栈顶落在 com.openai.core 的 JSON 处理
kotlin-stdlib / kotlin-reflect1.6.211.8.0 / 1.8.20NoSuchMethodError,或 NoClassDefFoundError: kotlin/...
okhttp(okhttp-bom)4.9.34.12.0发请求时才炸,栈里能看到 okhttp3
spring-boot-starter 构件无4.45.0 之后不再发布Could not find artifact

Spring Boot 2.7.18 的 BOM 把 Jackson、Kotlin、OkHttp 三个依赖压回老版本的对照图

一条 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传递依赖多,同样要顶三个版本
只有一个调用点,不想动 BOMHttpURLConnection 手写转义、超时、重试、流式全自己写
能升到 JDK 17 + Boot 3.5Spring AI 1.1.x要改 javax→jakarta,工作量在迁移不在 AI
能升到 JDK 17+ 且 Boot 4.xSpring AI 2.xBoot 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-starterstarter 在 4.45.0 后停发删掉 starter,手写 OpenAIClient Bean
NoSuchMethodError,栈顶在 com.openai.coreJackson 被压回 2.13.5顶 jackson-bom.version=2.18.9
NoSuchMethodError: kotlin.* 或 NoClassDefFoundError: kotlin/...kotlin-stdlib 被压回 1.6.21顶 kotlin.version=1.8.20
请求阶段 NoSuchMethodError,栈里有 okhttp3OkHttp 被压回 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 断线续跑的最小接入》——那篇讲状态恢复,这篇讲版本与依赖,正好互补。

登录后可点赞、收藏与反馈。

继续阅读 NEXT

更多 →