Jenkinsfile中用Heredoc替代echo -e失败，请求排查错误

常见失败原因 #

• Heredoc结束标记格式错误：Shell要求Heredoc的结束标记EOF必须单独占一行，且行首不能有任何空格、制表符或缩进，否则Shell无法识别结束标记，命令会一直等待输入。
• Groovy与Shell变量插值冲突：如果${VARIABLE_1}是Shell环境变量而非Groovy变量，Groovy会提前解析这些变量，导致Shell收到空白或错误的值。
• 换行符格式问题：Jenkins的sh步骤处理多行字符串时，若包含Windows格式换行符（\r\n），可能导致Shell解析异常。

修复后的代码示例 #

场景1：变量是Groovy/Jenkins环境变量 #

确保EOF顶格，Groovy正常插值变量：

sh("""cat <<EOF >> gradle.properties
SOME_KEY=${VARIABLE_1}
ANOTHER_KEY=${VARIABLE_2}
YET_ANOTHER_KEY=${VARIABLE_3}
EOF""")

注意：<<EOF后不要加空格，EOF必须顶格书写，不能有任何前置缩进。

场景2：变量是Shell环境变量 #

转义美元符号或用单引号包裹EOF，让Groovy不提前插值，交给Shell处理：

# 方式1：用单引号包裹EOF，Shell原样输出内容
sh("""cat <<'EOF' >> gradle.properties
SOME_KEY=\${VARIABLE_1}
ANOTHER_KEY=\${VARIABLE_2}
YET_ANOTHER_KEY=\${VARIABLE_3}
EOF""")

# 方式2：转义$符号，避免Groovy插值
sh("""cat <<EOF >> gradle.properties
SOME_KEY=\${VARIABLE_1}
ANOTHER_KEY=\${VARIABLE_2}
YET_ANOTHER_KEY=\${VARIABLE_3}
EOF""")

替代方案：提前构造内容再写入 #

如果Heredoc仍有问题，可以先在Groovy中构造好内容，再通过Shell写入文件：

def propsContent = """
SOME_KEY=${VARIABLE_1}
ANOTHER_KEY=${VARIABLE_2}
YET_ANOTHER_KEY=${VARIABLE_3}
"""
sh("echo '${propsContent}' >> gradle.properties")

注意：若变量内容包含单引号，需要额外转义。

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