Spring Boot + LangChain4j 报错：Bean 类型不匹配的解决办法

在使用 Spring Boot + LangChain4j 开发 AI 应用时，在 Service 工厂中注入如下两个Bean：

@ResourceprivateStreamingChatModelopenAiStreamingChatModel;@ResourceprivateStreamingChatModelreasoningStreamingChatModel;

一切看起来都很合理，但启动时就报如下错误❌：

Bean named'openAiStreamingChatModel'is expected to be oftype'dev.langchain4j.model.chat.StreamingChatModel'but was actually oftype'dev.langchain4j.model.openai.OpenAiStreamingChatModel'

最诡异的是OpenAiStreamingChatModel明明是StreamingChatModel的子类，期望类型和实际类型“看起来完全兼容”，但还是报错！

原因分析

这个错误的根源，其实不是代码逻辑的问题，而是spring-boot-devtools的热部署机制导致的类加载冲突。

Spring Boot DevTools 为了实现快速重启，使用了两个类加载器。
一个是Base ClassLoader，主要负责加载Spring Boot 框架、第三方 jar（比如 langchain4j-core.jar）；

另一个是Restart ClassLoader，主要负责加载自己的项目代码（比如src/main/java）。

默认情况下，DevTools 会把 所有非项目代码的 jar 放入 Base ClassLoader。

但是！

LangChain4j 这类库，通过 Maven 引入，它其实是属于“第三方依赖”，理应由Base ClassLoader加载。

然而，在某些版本或配置下，DevTools 可能错误地将部分LangChain4j类交给了Restart ClassLoader。

这样就造成同一个类，有两个身份，这样 JVM 认为这是两个完全无关的类。即使包名、类名、继承关系都对，也无法进行类型转换或赋值。

解决方案

1.在项目的如下目录中创建文件：

src/main/resources/META-INF/spring-devtools.properties

2.文件内容如下，主要目的是告诉 DevTools，这些 jar 属于基础类路径，统一用Base ClassLoader加载。

restart.include.langchain4j=/langchain4j-.*\.jar restart.include.openai=/openai-.*\.jar

3.重新运行，问题解决。