Jenkins执行shell报Unterminated quoted string错误排查

云上老周

2026-9-1

根因分析

报错Syntax error: Unterminated quoted string属于Shell执行层的语法错误，和Python脚本本身无关。生产环境长期稳定运行、仅特定开发者分支触发该问题，核心原因是Groovy变量插值时引入的特殊字符破坏了Shell的引号闭合规则：

你使用的是Jenkins Pipeline三双引号"""包裹的Shell脚本块，Groovy会在把脚本传给sh步骤前，先完成所有$开头变量、${}表达式的插值替换，替换后的纯文本才会被放到Shell中执行。
原代码中没有对插值进来的${env.CHANGE_AUTHOR_DISPLAY_NAME}、${validFilePath}做任何Shell转义，只要这两个值里包含单引号、未配对引号、Shell元字符，就会直接打断原有引号结构。本次问题大概率是出问题分支的提交者昵称包含单引号（例如O'Conner格式的名称），或是分支关联的文件路径validFilePath包含空格、单引号，导致Shell解析时发现引号没有正常闭合。
你之前尝试的加反斜杠转义单引号的方案完全无效：在Groovy三双引号字符串语法中，\'转义后最终传给Shell的还是普通单引号，既没有改变原有引号结构，也没有对插值变量做特殊字符处理，自然无法解决问题。
额外的隐藏问题：原代码中'$SOME_ID'、'$SOME_TOKEN'的写法不符合预期——Groovy在三双引号块中会直接解析$SOME_ID变量，如果这两个值是Shell上下文的变量而非Groovy变量，原有写法会直接取空值。

修复方案

按稳定性优先级排序，可任选一种方案修复：

方案1（最推荐，彻底规避转义问题）：使用三单引号'''包裹Shell脚本，关闭Groovy自动插值，通过sh步骤的environment参数显式传入Jenkins侧变量，从根源上避免特殊字符破坏Shell语法。
示例代码：
```
sh(
    script: '''
        . .venv/bin/activate
        python3 -m some_python_package.some_sub_package.script --stage update_something \
            --api PROD "$SOME_ID" "$SOME_TOKEN" \
            --user_id "$CHANGE_AUTHOR_NAME" \
            --file_list "$TARGET_FILE_LIST" 2>&1 | tee output/log.txt
    ''',
    environment: [
        CHANGE_AUTHOR_NAME: env.CHANGE_AUTHOR_DISPLAY_NAME,
        TARGET_FILE_LIST: validFilePath
    ]
)
```
该写法下Groovy不会对三单引号内的脚本做任何插值修改，所有变量由Shell自行解析，传入的环境变量值会被完整识别，无论变量里包含单引号、空格还是其他特殊字符，都不会被当做Shell语法解析。

方案2（保留三双引号写法）：对所有Groovy插值的变量做Shell安全转义，借助Jenkins内置的转义工具处理特殊字符。
示例代码：

import org.apache.commons.text.StringEscapeUtils
sh """
    . .venv/bin/activate
    python3 -m some_python_package.some_sub_package.script --stage update_something \
        --api PROD '$SOME_ID' '$SOME_TOKEN' \
        --user_id "${StringEscapeUtils.escapeShell(env.CHANGE_AUTHOR_DISPLAY_NAME)}" \
        --file_list "${StringEscapeUtils.escapeShell(validFilePath)}" 2>&1 | tee output/log.txt
"""

注意：如果SOME_ID、SOME_TOKEN是Groovy侧变量而非Shell环境变量，同样需要用escapeShell方法处理后再插值。

快速验证方式：直接打印出问题分支的env.CHANGE_AUTHOR_DISPLAY_NAME和validFilePath值，和正常分支的取值对比，即可快速定位是哪个变量带入了破坏语法的特殊字符。

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