Railflow CLI导入Cucumber用例时忽略数据表仅显示首行问题

问题背景 #

近期搭配使用TestRail与Railflow，通过Railflow CLI同步Cucumber/Gherkin语法编写的测试用例，原有流程为：

• 测试执行结果导出为JSON格式文件
• Railflow CLI读取JSON文件，自动在TestRail中生成对应测试用例
  此前全流程运行无异常，近期出现同步故障：携带Data Table的测试场景无法完整同步，步骤仅保留首行文本，所有数据表内容全部缺失。

故障复现的Gherkin步骤示例：

Then I verify "abc" table column headers to be
  | columnName  |
  | Subject     |
  | Report Data |
  | Action      |
  | ER Type     |

同步到TestRail后，该步骤仅显示Then I verify "abc" table column headers to be，下方所有表格行完全丢失。

排查方案与解决方法 #

• 第一步校验中间JSON文件完整性
  直接打开Cucumber生成的、供Railflow读取的JSON结果文件，定位到对应故障步骤的节点，检查rows字段下是否完整存储了Data Table的所有行数据。
  如果JSON文件中本身就没有表格内容，故障点在Cucumber报告生成环节，和Railflow无关：检查近期是否升级过Cucumber版本、修改过报告导出配置，Cucumber 6.0以上部分版本默认开启了步骤数据省略开关，会过滤掉Data Table内容，关闭报告配置中类似--no-step-data的参数，确保报告全量输出步骤附属内容即可。
• 若JSON中表格内容完整，排查Railflow侧配置与版本问题
  1. 核对Railflow CLI版本：2.3.0~2.4.1区间的多个版本存在已知的Gherkin Data Table解析bug，会直接跳过步骤下挂载的表格节点不做解析，处理方式为回退到2.2.7稳定版，或升级到2.4.2及以上已修复该bug的版本即可。
  2. 检查CLI运行参数：确认近期是否调整过同步配置，若误开启exclude_data_tables、truncate_long_steps类参数，会直接过滤表格内容、截断长步骤文本，将对应参数设置为false关闭即可。
  3. 校验自定义步骤模板：如果此前修改过Railflow同步到TestRail的步骤渲染模板，检查模板中是否遗漏了{{step.data_table}}渲染变量，缺失该变量时模板不会拼接表格内容，补全变量或重置为官方默认模板即可恢复正常同步。
• 临时兼容方案
  若暂时无法调整版本或修改配置，编写Gherkin用例时可将Data Table内容以Markdown表格格式写在步骤注释中，Railflow会将这部分内容识别为普通文本同步到TestRail，不会出现内容丢失问题。

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