XTDB项目中ClojureScript与xtdb-core beta6依赖冲突解析

在XTDB项目的最新开发中，我们发现了一个值得注意的技术问题：当ClojureScript项目(如XTDB Play)尝试升级到xtdb-core beta6版本时，会遭遇Google Closure Compiler的兼容性问题。这个问题源于xtdb-core beta6引入的protobuf-java依赖与现有环境产生了版本冲突。

问题背景

XTDB作为一款分布式时序数据库，其核心组件xtdb-core在beta6版本中引入了protobuf-java作为新的依赖项。这一变更虽然为项目带来了新功能，却意外地导致了与ClojureScript编译环境的冲突。具体表现为在编译过程中抛出NoSuchMethodError异常，指向Google Closure Compiler的内部方法缺失。

技术细节分析

问题的根源在于protobuf-java依赖链中包含了特定版本的Google Closure Compiler，这与ClojureScript项目所需的编译器版本产生了冲突。当开发者尝试构建项目时，系统会抛出如下错误：

NoSuchMethodError 'void com.google.javascript.jscomp.serialization.TypedAst.makeExtensionsImmutable()'

这种类型错误通常表明运行时加载的类版本与方法签名不匹配，是典型的依赖冲突表现。

解决方案探索

经过技术团队的深入调查，我们尝试了多种解决方案：

1. 直接排除冲突依赖：最初尝试在deps.edn中排除protobuf-java依赖：

  com.xtdb/xtdb-core {:mvn/version "2.0.0-beta6"
                      :exclusions [com.google.protobuf/protobuf-java]}

这种方法在开发环境下看似有效，但在最终构建阶段会因缺少必要的protobuf类而失败。

2. 显式指定兼容版本：最终采用的解决方案是排除默认版本并显式指定一个兼容的protobuf-java版本：

  com.xtdb/xtdb-core {:mvn/version "2.0.0-beta6"
                      :exclusions [com.google.protobuf/protobuf-java]}
  com.google.protobuf/protobuf-java {:mvn/version "3.25.5"}

这种方法成功解决了编译问题，同时保证了XTDB核心功能的正常运行。通过依赖树检查可以看到，系统现在使用了我们显式指定的protobuf-java 3.25.5版本，而非默认的4.28.3版本。

技术影响评估

这种依赖冲突在Clojure/ClojureScript生态系统中并不罕见，特别是在涉及Java原生库时。对于XTDB项目而言：

1. 目前主要影响的是嵌入XTDB v2作为进程内数据库的ClojureScript项目
2. 生产环境中使用进程内API的用户群体目前较少
3. 解决方案虽然有效，但需要开发者对依赖管理有一定了解

最佳实践建议

对于遇到类似问题的开发者，我们建议：

1. 始终检查项目的完整依赖树(clj -Stree)
2. 优先尝试显式指定版本而非完全排除依赖
3. 在开发环境和生产环境都进行全面测试
4. 关注官方文档和社区讨论获取最新解决方案

XTDB团队将持续关注这一问题的发展，并在必要时提供更完善的解决方案。开发者如遇到任何相关问题，欢迎通过官方渠道反馈。