GitLab CI执行含空格参数的JMeter命令报错如何解决

问题根本原因 #

报错是YAML、shell两层解析规则冲突导致的：GitLab CI的YAML解析器会先处理script字段下的字符串，提前移除你写的外层双引号，最终传给shell执行的命令里，带空格的series_filter参数没有有效引号包裹，被shell拆分为多个独立参数，JMeter识别到意外的-字符就抛出格式错误。

可行解决方案 #

方案1：使用YAML字面量块标量（最省心，无需转义） #

用|块标量符包裹整条JMeter命令，YAML会原封不动保留命令里的所有引号、空格，不会提前解析删除：

image:
  name: justb4/jmeter:latest
  entrypoint: [""]
api test:
  stage: test
  script:
    - mkdir xyzresults
    - |
      /entrypoint.sh -n -t ./XYZ_login_dashboard_machine_actor_card_XYZ.jmx -l ./dcs.log -f -Jthreads=40 -Jrampup=40 -JtestCases=100 -JBASE_URL_2=qa2s.nayax.com -e -o ./dcsresults -Jjmeter.reportgenerator.exporter.html.series_filter="^(Actor|Actor - Update Work Hours)(-success|-failure)?$"

方案2：把带空格的参数提取为CI变量 #

将过滤规则单独定义为CI变量，用单引号包裹变量值避免转义冲突，执行时直接引用变量即可：

variables:
  JMETER_SERIES_FILTER: '^(Actor|Actor - Update Work Hours)(-success|-failure)?$'

image:
  name: justb4/jmeter:latest
  entrypoint: [""]
api test:
  stage: test
  script:
    - mkdir xyzresults
    - /entrypoint.sh -n -t ./XYZ_login_dashboard_machine_actor_card_XYZ.jmx -l ./dcs.log -f -Jthreads=40 -Jrampup=40 -JtestCases=100 -JBASE_URL_2=qa2s.nayax.com -e -o ./dcsresults -Jjmeter.reportgenerator.exporter.html.series_filter="$JMETER_SERIES_FILTER"

方案3：使用单引号直接包裹参数值 #

直接把过滤规则用单引号包裹，YAML不会解析单引号内的内容，也能避免空格被拆分：

script:
  - mkdir xyzresults
  - /entrypoint.sh -n -t ./XYZ_login_dashboard_machine_actor_card_XYZ.jmx -l ./dcs.log -f -Jthreads=40 -Jrampup=40 -JtestCases=100 -JBASE_URL_2=qa2s.nayax.com -e -o ./dcsresults -Jjmeter.reportgenerator.exporter.html.series_filter='^(Actor|Actor - Update Work Hours)(-success|-failure)?$'

之前方案无效的原因 #

• 单引号包裹双引号的写法：YAML解析后会先移除外层单引号，传给shell的参数仍然没有有效包裹，空格还是会被拆分
• 仅给双引号加单个反斜杠转义：YAML会把\"解析为普通双引号，还是会被提前移除，不会传给shell
• 单引号包裹整条命令：shell会把单引号内的所有内容当做普通字符串处理，不会解析内部的引号规则，才会出现末尾引号丢失的问题

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