如何使用Jenkins Groovy Script-Console向指定路径写入文件

Groovy 中String.execute()方法底层直接调用操作系统的exec接口，默认不会启动Shell解释器，所有Shell专属语法（重定向>、管道|、 heredoc <<EOF等）都无法被识别，只会被当成命令的普通参数处理，这是你给出的几种写法绝大多数情况下失败的核心原因。
逐个说明各写法的具体问题：

• 第一种写法：>和文件路径被当成echo的普通参数，最终只会把'the text' > /mnt/efs-ci-state/path/to/the-state-file.txt整串打印输出，不会执行重定向写入操作。
• 第二种heredoc写法：没有Shell解释heredoc语法，整串内容会被当成cat的参数，直接报错。
• 第三种bash -c写法：语法逻辑本身是成立的，执行失败通常是两个原因：一是要写入的内容包含单引号，打破了bash -c的参数边界；二是Jenkins执行用户（默认是jenkins用户）没有目标EFS路径的写入权限，或者路径不存在。
• 第四种管道写法：|和tee命令被当成echo的普通参数，不会触发管道执行逻辑。

方案一：纯Groovy原生文件写入（最推荐） #

不需要调用外部命令，完全用Groovy原生API实现，没有Shell转义、进程调度的坑，稳定性最高：

// 定义要写入的内容，支持多行、特殊字符
def writeContent = "the text"
// 初始化目标文件对象
def stateFile = new File("/mnt/efs-ci-state/path/to/the-state-file.txt")
// 覆盖写入内容，如需追加内容改用stateFile.append(writeContent)
stateFile.text = writeContent
// 如需指定编码可以使用如下写法
// stateFile.setText(writeContent, "UTF-8")

方案二：执行带Shell语法的复杂命令通用方法 #

如果确实需要使用管道、重定向等Shell语法实现复杂逻辑，要显式指定用Bash执行，用数组形式传参避免转义问题，同时要等待命令执行完成后再获取结果：

// 写入Shell命令，支持管道、重定向、多行命令
def shellCmd = """
echo 'the text' | tee /mnt/efs-ci-state/path/to/the-state-file.txt
# 可直接写多行业务逻辑，比如过滤排序后写入文件
# grep "status=success" /tmp/run.log | sort > /tmp/success.log
"""
// 数组形式调用Bash执行命令，避免转义错误
def execProcess = ["bash", "-c", shellCmd].execute()
// 阻塞等待命令执行完成
execProcess.waitFor()
// 获取执行信息用于排查问题
def exitCode = execProcess.exitValue()
def stdout = execProcess.inputStream.text
def stderr = execProcess.errorStream.text

println "命令执行退出码：${exitCode}"
println "标准输出：\n${stdout}"
println "错误输出：\n${stderr}"

• Jenkins脚本控制台默认在Master节点的jenkins用户下执行命令，如果需要在Agent节点操作，需要把逻辑包在node('目标节点标签') { ... }代码块中。
• 执行前先确认jenkins用户对目标EFS路径有读写权限，路径不存在的话要提前创建父目录。
• 写入内容包含单引号、双引号、换行等特殊字符时，优先使用方案一的原生写法，避免Shell转义的各类问题。

内容的提问来源于stack exchange，提问作者Radagast the Brown