Robot Framework分析JMeter结果时出现JMeterLibException日志格式错误

• 当前运行环境依赖：Python 2.7.18 版本，Robot Framework 生态下配套的JMeterLib适配JMeter 2.12版本
• 实际执行的Robot Framework逻辑：

  ${logPath}=    set variable    C:/Tests/output1.log
  run jmeter    C:/Tests/apache-jmeter-5.4.1/bin/jmeter.bat    C:/Tests/100users.jmx    ${logPath}
  ${result}    analyse jtl convert    ${logPath}
  log    ${result}
  FOR    ${ELEMENT}    IN    @{result}
      log dictionary    ${ELEMENT}
  

• 异常表现：调用结果解析关键字时触发JMeterLibException，报错信息为Incorrect log file format

• 跨版本格式不兼容：JMeterLib适配2.12版本的解析逻辑，仅能识别该版本默认输出的固定结构JTL结果文件；脚本中实际调用的JMeter 5.4.1版本，默认生成的结果文件带有字段头元数据、扩展字段输出，列结构和旧版本存在本质差异，无法被旧版解析逻辑识别
• 日志路径指向错误：脚本中给run jmeter和analyse jtl convert传入的${logPath}，没有明确区分JMeter程序运行日志、压测结果JTL文件的边界，导致解析器拿到的文件完全不是预期的JTL数据结构
• 库版本适配断层：Python 2.7.18生态下的JMeterLib停止迭代较早，从未适配JMeter 3.0之后版本的结果输出格式，跨大版本调用时必然触发格式校验失败

• 对齐版本匹配关系：将脚本中run jmeter关键字传入的JMeter可执行文件路径，替换为JMeterLib原生适配的JMeter 2.12版本对应jmeter.bat路径，消除跨版本格式差异
• 分离不同日志的路径指向：
  • 调用run jmeter关键字时，第三个参数传入的路径明确指定为压测结果JTL文件路径，例如C:/Tests/100users_result.jtl，不要将JMeter自身的程序运行日志（默认生成在JMeter安装目录的bin/jmeter.log）和压测结果文件混用
  • 调用analyse jtl convert时，传入的路径必须严格指向上述压测生成的JTL结果文件，不要传入程序运行日志路径
• 强制对齐旧版输出格式：如果必须使用JMeter 5.4.1执行压测，需要修改JMeter安装目录下的bin/user.properties配置，强制将结果输出格式调整为旧版可识别的结构：
  • 关闭结果文件头部字段名输出：设置jmeter.save.saveservice.print_field_names=false
  • 移除JMeter 5.4.1默认开启的扩展输出字段，固定列顺序为JMeter 2.12版本的默认输出列集
• 校验目标文件格式：打开传入解析逻辑的目标文件，确认文件内容为逐行记录的压测请求数据（包含响应时间、状态码、样本名称等结构化字段），而非包含Java启动信息、运行栈追踪的程序日志。

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