Jenkins执行Shell行为异常：Python与Shell脚本执行顺序颠倒

问题原因 #

Python的标准输出默认采用缓冲模式，而Shell脚本的输出是实时刷新到控制台的。Jenkins的输出捕获机制下，Python缓冲的内容会等到缓冲区填满或脚本结束才会打印，导致Shell脚本的输出先于Python的print内容显示，和终端执行的顺序不一致。

解决方法 #

方法1：运行Python时禁用输出缓冲 #

在Jenkins的Shell命令中，给python3加上-u参数（强制标准输出/错误无缓冲）：

python3 -u pythonScriptFile.py "${arg1}" "${arg2}" "${arg3}"

方法2：在Python脚本中手动刷新缓冲区 #

修改Python里的print语句，添加flush=True参数强制实时输出，同时修正原代码的错误：

import os
import sys

print("SCRIPT Started", flush=True)
# os.system返回的是命令退出码，不是进程对象，原代码的process.wait()无效，需删除
exit_code = os.system(f"""sh script.sh -t {arg1} -e {arg2}""")
if exit_code != 0:
    print("Error executing build script", flush=True)
    sys.exit(1)
print("SCRIPT COMPLETED", flush=True)

方法3：改用subprocess模块替代os.system #

subprocess模块比os.system更灵活可控，能更好地处理输出同步：

import subprocess
import sys

print("SCRIPT Started", flush=True)
try:
    # 捕获脚本输出并按顺序打印
    result = subprocess.run(
        ["sh", "script.sh", "-t", arg1, "-e", arg2],
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,
        text=True,
        check=True
    )
    print(result.stdout, flush=True)
except subprocess.CalledProcessError as e:
    print(f"Error executing build script: {e.output}", flush=True)
    sys.exit(e.returncode)
print("SCRIPT COMPLETED", flush=True)

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