Jenkins Pipeline中PYTEST_RESULT环境变量无法覆盖问题求助

我正在学习编写Jenkinsfile，熟悉Jenkins Pipeline的环境变量（内置+自定义）用法。目前其他变量都正常，但自定义环境变量PYTEST_RESULT始终无法覆盖初始值——明明后续用拼接值赋值，它却一直保留着初始的"TBD"。下面是可复现的代码和我的尝试，求解决办法。

1. 最小可复现Jenkinsfile #

// 声明全局变量:
def pytestExitCode = ''
def pytestExitCodeDesc = ''
    
pipeline {
    agent any
    environment{
        PROJECT_NAME = "BigTime Web Transformation"
        PYTEST_RESULT = "TBD"
    }

   stages {
        stage('Test') {
            steps {
                sh '''
                    export pytestExitCode
                    echo "pytestExitCode before being assigned the pytest exit code is: "$pytestExitCode
                '''
                script {
                    pytestExitCode = sh(returnStatus: true, script: 'pytest')
                    echo "Pytest completed with exit code: ${pytestExitCode}"
                }
            }
        }
   }

    post {
        always {
            script {
                switch(pytestExitCode) {
                    case 0:
                        pytestExitCodeDesc = "All tests were collected and passed successfully"
                        break;
                    default:
                        println("Pytest was not a complete success..");
                        break;
                }
                // 准备环境变量值传递给邮件模板:
                env.BUILD_ID=sh(script: 'echo ${BUILD_ID}', returnStdout: true)
                echo env.BUILD_ID
                
                env.PROJECT_NAME=sh(script: 'echo ${PROJECT_NAME}', returnStdout: true)
                echo env.PROJECT_NAME
                
                // 这里不生效:
                env.PYTEST_RESULT = "${pytestExitCode} - '${pytestExitCodeDesc}'"
                // PYTEST_RESULT仍然保留初始值'TBD'..
                env.PYTEST_RESULT=sh(script: 'echo ${PYTEST_RESULT}', returnStdout: true)
                echo env.PYTEST_RESULT
            }
        }
    }
}

2. 关联的pytest文件 #

add.py #

def add(x,y):
    return x+y

test_add.py #

import os
import sys
// 根据Jenkins任务名动态更新路径，让Python能递归查找构建和测试脚本的最上层目录:
sys.path.append(os.environ.get('PWD'))
from ops import *
def test_add():
    assert add(3,4) == 7

3. 最新尝试的代码（仍未解决） #

pipeline {
    agent any
    environment{
        PROJECT_NAME = "BigTime Web Transformation"
        PYTEST_EXIT_CODE = "TBD"
        PYTEST_RESULT = "TBD"
    }

   stages {
        stage('Test') {
            environment {
                PYTEST_EXIT_CODE = sh(returnStatus: true, script: 'pytest')
            }
            steps {
                script {
                    switch(PYTEST_EXIT_CODE) {
                        case '0':
                            pytestExitCodeDesc = "All tests were collected and passed successfully"                            
                            PYTEST_RESULT = "${PYTEST_EXIT_CODE} - '${pytestExitCodeDesc}'"
                            echo "PYTEST_RESULT in Case 0's section is: ${PYTEST_RESULT}"
                            break;
                        default:
                            pytestExitCodeDesc = "Pytest has no desc as it was not a complete success.."
                            break;
                    }
                }
            }
        }
   }

    post {
        always {
            echo "PYTEST_RESULT in Post's always section is: ${PYTEST_RESULT}"  // 这里现在生效了..

            script {
                // 准备环境变量值传递给邮件模板:
                env.BUILD_ID=sh(script: 'echo ${BUILD_ID}', returnStdout: true)
                echo env.BUILD_ID
                
                env.PROJECT_NAME=sh(script: 'echo ${PROJECT_NAME}', returnStdout: true)
                echo env.PROJECT_NAME
                
                env.PYTEST_RESULT=sh(script: "echo ${PYTEST_RESULT}", returnStdout: true) // 这里现在生效了..
                echo env.PYTEST_RESULT // 但这里还是拉取初始值..
           }
        }
    }
}

问题原因与解决思路 #

核心问题1：Groovy变量与env环境变量混淆 #

在stage的script块里直接给PYTEST_RESULT赋值时，实际创建的是局部Groovy变量，而非更新env.PYTEST_RESULT这个系统环境变量。所以post块里直接用${PYTEST_RESULT}能读取到局部变量，但执行env.PYTEST_RESULT=sh(...)时，sh脚本读取的是系统环境里的初始值，导致环境变量被重新覆盖回"TBD"。

核心问题2：sh脚本读取环境变量的时机 #

Jenkins Pipeline会把env中的环境变量注入到sh脚本上下文，但只有sh块执行前已存在的env变量才会被注入。Groovy局部变量不会自动同步到系统环境，所以sh 'echo ${PYTEST_RESULT}'读取的始终是初始的环境变量值。

具体修复步骤 #

1. 统一操作env.PYTEST_RESULT：
   全程用env.PYTEST_RESULT赋值和读取，确保操作的是同一个系统环境变量，而非局部Groovy变量。

2. 跳过sh脚本回读环境变量：
   在Groovy里赋值env.PYTEST_RESULT后，直接用echo env.PYTEST_RESULT输出即可，不需要通过sh 'echo ${PYTEST_RESULT}'绕圈——后者只会读取系统环境里的旧值。

3. 修正stage内环境变量赋值方式：
   stage的environment块不支持sh(returnStatus: true)（返回整数，不符合环境变量字符串要求），应把pytest执行放到script块里，再赋值给env.PYTEST_EXIT_CODE。

修复后的示例代码 #

def pytestExitCodeDesc = ''
    
pipeline {
    agent any
    environment{
        PROJECT_NAME = "BigTime Web Transformation"
        PYTEST_RESULT = "TBD"
        PYTEST_EXIT_CODE = "TBD"
    }

   stages {
        stage('Test') {
            steps {
                script {
                    // 把pytest退出码转成字符串后赋值给环境变量
                    env.PYTEST_EXIT_CODE = sh(returnStatus: true, script: 'pytest').toString()
                    echo "Pytest completed with exit code: ${env.PYTEST_EXIT_CODE}"
                    
                    // 直接更新系统环境变量PYTEST_RESULT
                    switch(env.PYTEST_EXIT_CODE) {
                        case '0':
                            pytestExitCodeDesc = "All tests were collected and passed successfully"                            
                            env.PYTEST_RESULT = "${env.PYTEST_EXIT_CODE} - '${pytestExitCodeDesc}'"
                            echo "PYTEST_RESULT in Test stage: ${env.PYTEST_RESULT}"
                            break;
                        default:
                            pytestExitCodeDesc = "Pytest was not a complete success.."
                            env.PYTEST_RESULT = "${env.PYTEST_EXIT_CODE} - '${pytestExitCodeDesc}'"
                            break;
                    }
                }
            }
        }
   }

    post {
        always {
            echo "PYTEST_RESULT in Post section: ${env.PYTEST_RESULT}"

            script {
                // 内置变量直接使用，无需重新赋值
                echo "BUILD_ID: ${env.BUILD_ID}"
                echo "PROJECT_NAME: ${env.PROJECT_NAME}"
                
                // 直接输出环境变量
                echo "Final PYTEST_RESULT: ${env.PYTEST_RESULT}"
           }
        }
    }
}

额外注意点 #

• 内置环境变量（如BUILD_ID）无需重新赋值，直接通过env.BUILD_ID使用即可。
• sh(returnStatus: true)返回整数，赋值给环境变量时要转成字符串（.toString()），避免类型冲突。
• 若要在sh脚本中使用Groovy局部变量，需用双引号包裹脚本注入，比如sh """echo ${pytestExitCodeDesc}"""。

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