如何解决druid在OpenJDK11+Gradle中的依赖问题

# 如何解决Druid在OpenJDK11+Gradle中的依赖问题

## 引言

在Java生态系统中，Apache Druid作为高性能的实时分析数据库被广泛使用，而OpenJDK11作为LTS版本已成为许多项目的标准JDK。当开发者使用Gradle构建工具在OpenJDK11环境下集成Druid时，常会遇到依赖冲突、类加载异常或兼容性问题。本文将系统分析这些问题的成因，并提供可落地的解决方案。

## 一、问题现象分析

### 1.1 典型报错场景
```bash
java.lang.NoClassDefFoundError: javax/xml/bind/AnnotationException

或

Module xxx reads package javax.annotation from both java.annotation and jsr305

1.2 根本原因

• JEP 320移除了JavaEE模块：OpenJDK11移除了javax.xml.bind等JavaEE模块
• 传递依赖冲突：Druid依赖的第三方库(如metrics-core)可能引入了与JDK模块冲突的JAR
• Gradle依赖解析策略：默认的依赖解析可能未正确处理模块化冲突

二、解决方案

2.1 添加缺失的JavaEE模块

在build.gradle中添加显式依赖：

dependencies {
    implementation 'javax.xml.bind:jaxb-api:2.3.1'
    implementation 'com.sun.xml.bind:jaxb-core:2.3.0.1'
    implementation 'com.sun.xml.bind:jaxb-impl:2.3.1'
    implementation 'javax.annotation:javax.annotation-api:1.3.2'
}

2.2 使用Gradle依赖约束

强制统一依赖版本：

dependencies {
    constraints {
        implementation('com.google.code.findbugs:jsr305') {
            version { strictly '3.0.2' }
        }
    }
}

2.3 模块化配置（针对JPMS）

在module-info.java中添加：

requires java.sql;
requires transitive java.xml.bind;

三、进阶配置技巧

3.1 依赖排除策略

implementation('com.alibaba:druid:1.2.16') {
    exclude group: 'com.google.guava', module: 'guava'
    exclude group: 'org.slf4j', module: 'slf4j-api'
}

3.2 使用ResolutionStrategy

configurations.all {
    resolutionStrategy {
        force 'org.checkerframework:checker-qual:3.12.0'
        preferProjectModules()
    }
}

3.3 构建扫描诊断

运行命令生成依赖树报告：

./gradlew build --scan

四、完整配置示例

4.1 build.gradle完整配置

plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation('com.alibaba:druid:1.2.16') {
        exclude group: 'javax.annotation', module: 'javax.annotation-api'
    }
    
    // JavaEE兼容依赖
    implementation 'javax.xml.bind:jaxb-api:2.3.1'
    implementation 'org.glassfish.jaxb:jaxb-runtime:2.3.1'
    
    // 测试配置
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
}

tasks.withType(JavaCompile) {
    options.compilerArgs += ['--release', '11']
}

五、验证方案

5.1 依赖树检查

./gradlew dependencies --configuration runtimeClasspath

5.2 单元测试验证

创建测试类验证数据库连接：

public class DruidTest {
    @Test
    void testConnection() throws SQLException {
        DruidDataSource ds = new DruidDataSource();
        ds.setUrl("jdbc:h2:mem:test");
        assertNotNull(ds.getConnection());
    }
}

六、替代方案

如果问题持续存在，可考虑： 1. 降级到OpenJDK8 2. 使用HikariCP等兼容性更好的连接池 3. 等待Druid官方发布完全兼容JDK11的版本

结语

通过合理配置Gradle依赖和正确处理Java模块化系统，可以解决大多数Druid在OpenJDK11下的兼容性问题。建议开发者： 1. 定期更新依赖版本 2. 使用Gradle的依赖分析工具 3. 关注Druid项目的版本更新日志

提示：本文基于Druid 1.2.x版本和Gradle 7.x编写，不同版本可能需要调整解决方案。 “`