Java Gradle部署流水线无法下载kafka-avro-serializer等依赖问题求助

可能的故障原因 #

• 云端环境出站网络限制：云安全组、VPC出站规则拦截了去往confluent仓库的请求，或内网环境未配置合法代理，导致TCP连接被直接重置
• Gradle配置优先级覆盖：项目级的repositories配置被全局init.gradle、项目settings.gradle中的更高优先级仓库配置覆盖，confluent源未实际加入检索列表
• 镜像站规则拦截：如果配置了全局Maven镜像（如内部私有镜像、公共加速镜像），mirrorOf("*")类的全匹配规则会将所有依赖请求转发到镜像站，而镜像站未同步confluent 5.3.2版本的相关依赖
• HTTPS协议兼容问题：使用HTTPS地址时，云端环境JDK信任库缺失confluent仓库的SSL证书导致握手失败；使用HTTP地址时又触发confluent仓库的强制HTTPS跳转规则，最终连接被重置

排查步骤 #

• 先验证基础网络连通性：登录云端构建节点执行curl命令，确认对应地址是否可访问：

# 测试HTTP协议地址连通性
curl -v http://packages.confluent.io/maven/io/confluent/kafka-avro-serializer/5.3.2/kafka-avro-serializer-5.3.2.pom
# 测试HTTPS协议地址连通性
curl -v https://packages.confluent.io/maven/io/confluent/kafka-avro-serializer/5.3.2/kafka-avro-serializer-5.3.2.pom

如果curl同样返回连接重置，可直接定位为网络层面问题，联系云管理员放开对应出站规则或配置合法代理即可。

• 查看Gradle实际检索的仓库列表：执行./gradlew build --info命令构建，在日志中搜索Repositories关键字，确认confluent仓库是否在检索列表中，是否被其他配置覆盖。
• 检查全局镜像配置：查看~/.gradle/init.gradle、项目根目录settings.gradle文件，确认是否配置了全局镜像规则，如果有全匹配的镜像规则，需要将confluent仓库加入排除列表，或在对应镜像站中同步依赖。

解决方案 #

• 网络限制解除后，优先使用HTTPS协议的confluent仓库地址，若必须使用HTTP地址需添加allowInsecureProtocol参数避免Gradle安全拦截：

repositories {
    mavenCentral()
    maven {
        url "https://packages.confluent.io/maven/"
        // 必须使用HTTP协议时打开下方配置
        // allowInsecureProtocol = true
    }
}

• 若网络始终无法访问confluent官方仓库，可手动下载对应版本的jar和pom文件，上传到企业私有Maven仓库，将私有仓库地址加入Gradle配置即可。
• 临时应急可将两个依赖的jar包放入项目libs目录，通过本地依赖方式引入：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    // 其余原有依赖配置保持不变
}

内容的提问来源于stack exchange，提问作者sg_rs