如何在Jenkins Pipeline中退出Python脚本且不终止整个流水线

出现这个问题的核心原因是Python的exit(0)触发了同进程退出逻辑，对应两种常见场景：

• 未通过独立操作系统子进程调用Python脚本：比如用Jython环境内嵌执行Python、通过Groovy原生进程API直接拉起Python逻辑，此时exit(0)会直接终止Jenkins Agent的JVM进程，直接中断整个流水线
• 调用脚本的流水线步骤配置错误：默认的sh/bat步骤在部分旧版本Jenkins中，会把进程主动调用exit退出的行为识别为步骤执行中断，直接跳过后续逻辑

方案1：直接删除冗余的exit语句（成本最低） #

Python脚本执行到文件末尾时，会自动以状态码0退出，脚本末尾写的exit(0)本身就是冗余代码，直接删掉这行就不会触发异常退出逻辑，脚本跑完后会自动回到Groovy上下文继续执行后续代码。
如果需要显式指定退出码，用sys.exit()封装在主函数返回逻辑里即可，不要在脚本顶层直接写exit调用：

import sys

def main():
    # 业务逻辑写在这里
    return 0

if __name__ == "__main__":
    sys.exit(main())

这种写法在独立子进程执行时，只会终止Python自身进程，不会对外层进程造成影响。

方案2：调整流水线调用逻辑，强制隔离进程 #

永远用流水线内置的sh（Linux/macOS节点）或bat（Windows节点）步骤调用Python脚本，不要用Groovy原生的execute()方法、不要用第三方插件的内嵌Python执行模式，确保Python运行在和Jenkins Agent完全隔离的操作系统子进程中。调用时加上returnStatus: true参数捕获退出码，避免步骤误判终止：

pipeline {
    agent any
    stages {
        stage('执行业务脚本') {
            steps {
                script {
                    // 替换成你的脚本实际路径，Windows节点把sh换成bat
                    def pyExitCode = sh(
                        script: "python3 /data/scripts/your_biz.py",
                        returnStatus: true
                    )
                    echo "Python脚本执行完毕，退出码：${pyExitCode}"
                    
                    // 后续Groovy逻辑正常写在这里，会正常执行
                    echo "开始执行Python脚本后的后置Groovy逻辑"
                }
            }
        }
    }
}

方案3：无权修改Python脚本时加一层进程隔离封装 #

如果调用的是第三方维护的Python脚本，没法修改里面的exit(0)语句，就在调用时套一层子进程壳，把exit的影响范围限制在最内层进程：

// Linux/macOS节点
sh 'bash -c "python3 /data/scripts/third_party.py"'

// Windows节点
bat 'cmd /c "python C:\scripts\third_party.py"'

这种嵌套调用下，Python的exit只会终止自身进程，外层的bash/cmd会正常回收进程状态并返回给流水线，不会触发流水线提前终止。

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