Jira/xRay中Cucumber测试报告嵌入元素名称丢失问题

问题分析 #

Cucumber JSON报告的embeddings字段包含name属性，但XRay导入时未正确读取该字段，仅保留了附件内容和MIME类型，导致文件名丢失。

解决方案 #

1. 升级XRay插件版本 #

• 检查当前使用的XRay插件版本，部分旧版本未支持读取embeddings中的name字段，升级到最新稳定版后重新上传报告验证。

2. 调整附件内容格式 #

如果升级后问题仍存在，可将文件名嵌入到附件内容开头，确保用户能直接看到文件名：

// 在日志内容前添加文件名标识
String namedLogContent = "文件名: log.txt\n\n" + logText;
scenario.attach(namedLogContent, "text/plain", "log.txt");

3. 自定义API上传逻辑（自托管场景） #

若通过XRay API手动上传报告，可在上传前解析JSON，将embeddings的name字段映射到XRay支持的附件名称字段：

• 解析Cucumber JSON文件，提取每个embedding的name、data和mime_type
• 调用XRay的附件上传API，单独上传每个附件并指定文件名，关联到对应的测试场景

4. 使用XRay官方Cucumber集成库 #

替换手动上传JSON的方式，使用XRay官方提供的Cucumber集成依赖，在测试代码中直接对接XRay，上传附件时显式指定文件名，能更可靠地同步元数据。

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