【实战干货】Jenkins部署后项目启动总报“找不到类”？一招MD5校验，解决JAR传输不完整问题

Python运维开发

发布于 2025-09-29 14:13:53

1110

文章被收录于专栏：Python运维开发Python运维开发

最近项目上线遇到一个奇怪问题：服务启动时报 ClassNotFoundException，但重启一下又好了！ 一开始以为是偶然

经过排查，怀疑是 JAR包在传输过程中未完全传输完成，服务就启动了，导致java类加载失败。

为了解决这个问题，我在 Jenkins Pipeline 中加了MD5 校验机制，确保 JAR 包完整传输后才继续部署。

问题背景：为什么重启就正常了？

现象：多次发现发布后，部分节点报错“找不到某个类”，但手动重启服务后恢复正常。
怀疑：文件传输完全未完成，服务就启动了。
原因：网络波动、大文件传输、Jenkins步骤未等待传输完全完成。

解决方案：在启动服务前，校验源文件与目标文件的 MD5 值是否一致，不一致就等待重试。

Jenkins Pipeline 代码

下面是 Jenkins Pipeline 脚本，

思路是：

获取jenkins服务器 JAR 包的 MD5
检查发送到部署服务器 JAR 包 MD5
比对是否一致，如不一致？重试，超过阈值推出

Pipeline 脚本

stage("Jar Files Check") {
    steps {
        script {
            def sMd5 = sh(
                script: "ssh ${host} 'md5sum ${APP_SEND_PATH}/datacenter-${projectname}.jar' | awk '{print \$1}'",
               returnStdout: true
            ).trim()
            echo " 源文件 MD5: ${sMd5}"
            for (tHost : HOSTS) {
                stage("MD5 Check on ${tHost}") {
                    mRetries = 6
                    rCount = 0
                    boolean isOk = false
                    while (rCount < mRetries && !isOk) {
                        try {
                            def tMd5 = sh(
                                script: "ssh ${host} 'ssh ${tHost} md5sum ${Deploy_PATH}/datacenter-${projectname}.jar' | awk '{print \$1}'",
                                returnStdout: true
                            ).trim()
                            echo "${tHost} 当前 MD5: ${tMd5}"
                            if (sMd5 == tMd5) {
                                echo "${tHost}: JAR 传输完成，MD5 校验通过！"
                                isOk = true
                            } else {
                                echo "${tHost}: JAR 传输未完成，等待 10 秒重试..."
                                sleep(time: 10, unit: "SECONDS")
                                rCount++
                            }
                        } catch (Exception e) {
                            echo "${tHost}: 获取 MD5 失败: ${e}"
                            rCount++
                            sleep(time: 10, unit: "SECONDS")
                        }
                    }
                    if (!isOk) {
                        error "${tHost}: JAR 校验失败，已重试 ${mRetries} 次推出"
                    }
                }
            }
        }
    }
}