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

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

java 复制代码
@Resource
private StreamingChatModel openAiStreamingChatModel;

@Resource
private StreamingChatModel reasoningStreamingChatModel;

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

bash 复制代码
Bean named 'openAiStreamingChatModel' is expected to be of type 'dev.langchain4j.model.chat.StreamingChatModel' but was actually of type '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.在项目的如下目录中创建文件:

bash 复制代码
src/main/resources/META-INF/spring-devtools.properties

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

bash 复制代码
restart.include.langchain4j=/langchain4j-.*\.jar
restart.include.openai=/openai-.*\.jar

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

相关推荐
屿华AI5 小时前
AUTOSAR 实战-诊断工具 | UDS 0x27 安全访问的配置化实现:种子密钥算法插件化设计
python·测试工具·汽车
RobinDevNotes6 小时前
Claude Code 剪视频,不上传、不要 API Key
人工智能·python·音视频·开发工具·ipython
如夏倾城7 小时前
VRRP(虚拟路由器冗余协议Virtual Router Redundancy Protocol)
网络·python·网络协议·安全·智能路由器·负载均衡·信息与通信
IvanCodes7 小时前
LangChain(04):Runnable 与 LCEL 的执行与组合机制
python·langchain·agent
特创数字科技8 小时前
纯本地离线运行的文档脱敏工具(技术分享)
前端·驱动开发·python
东莞市云毅网络有限公司9 小时前
用 Playwright 搭一套问答平台引用监测的最小骨架
python·数据清洗·rag·企业知识库·文档解析
Thanks_ks9 小时前
【第 010 讲】全面掌握 Python 变量与常量:变量的定义与赋值 | 标识符与命名规范 | 变量的底层机制 | 常量与魔术数字
python·内存·变量·标识符·常量·赋值·命名规范
Flynt9 小时前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
飞Link10 小时前
灵巧手是什么?从机械结构、驱动方式到控制原理,认识机器人的精细操作能力
人工智能·python·机器人
用户03321266636711 小时前
使用 Python 快速查找并高亮 PDF 中的文本
python