LangChain4j 项目升级 Milvus 依赖以优化存储模块

背景介绍

在 LangChain4j 项目的开发过程中，团队发现当前使用的 Milvus 向量数据库 Java SDK 版本(2.4.2)存在两个显著问题：一是引入了过重的依赖包(约300MB)，二是与测试容器等工具存在兼容性问题。这些问题在构建 OSGi 插件时尤为明显，会导致生成的插件 JAR 文件体积过大。

问题分析

Milvus 作为一款高性能向量数据库，其 Java SDK 在 2.4.2 版本将所有功能模块打包在一起，包括 BulkWriter 等可能用不到的高级功能。这种设计导致了不必要的依赖传递，增加了项目体积。此外，该版本与测试工具链的兼容性问题也给开发带来了不便。

解决方案

Milvus 团队在 2.5.2 版本中进行了架构优化，将 SDK 拆分为两个独立模块：

• milvus-sdk-java：核心功能模块
• milvus-sdk-java-bulkwriter：批量写入功能模块

这种模块化设计使得开发者可以根据实际需求选择依赖，显著减少了不必要的依赖传递。对比两个版本的依赖树可以看到：

• 2.4.2 版本依赖树长达480行
• 2.5.2 版本依赖树精简了许多，主要包含 gRPC、Protobuf 等必要组件

技术实现细节

升级后的 Milvus SDK 2.5.2 主要依赖包括：

• gRPC 网络通信框架(1.59.1)
• Protocol Buffers 数据序列化(3.24.0)
• Apache Commons 工具库
• OkHttp HTTP客户端(4.12.0)
• Gson JSON处理库(2.10.1)

这些依赖都是向量数据库操作所必需的基础组件，相比旧版本减少了大量非核心依赖。

升级效益

1. 体积优化：依赖包大小从约300MB显著减少
2. 兼容性提升：解决了与测试容器等工具的兼容问题
3. 模块化设计：按需引入功能模块，避免不必要的依赖
4. 构建效率：加快构建速度，特别有利于OSGi等模块化系统

实施建议

对于使用 LangChain4j 的开发者，可以通过以下方式升级：

1. 更新项目依赖声明，直接指定 Milvus 2.5.2 版本
2. 对于 Maven 项目，可以使用 dependencyManagement 统一管理版本
3. 检查是否真的需要 BulkWriter 功能，如不需要可排除相关依赖

总结

LangChain4j 项目通过升级 Milvus SDK 版本，有效解决了依赖过重和兼容性问题。这一优化不仅提升了开发体验，也为后续功能扩展奠定了更好的基础。模块化设计是现代化Java库的发展趋势，开发者应当关注依赖管理的最佳实践，以构建更高效、更稳定的应用系统。