使用xRay importer导入Xray测试用例时出现无限阻塞卡顿问题

问题背景 #

• 操作目标：通过xRay importer功能批量更新现有Xray测试用例的action、expected result、description字段
• 初始异常表现：执行导入后长时间无进度反馈，呈现类似无限阻塞的状态；触发终止导入操作后，终止流程也会持续卡住无法完成
• 前置配置校验：导入所用CSV文件表头已包含test cases identifier、summary、Jira issue key必填字段，且完成了全部导入字段映射（未完成字段校验时无法正常启动导入流程，可排除基础配置缺失问题）
• 对照测试结果：简化导入内容，仅填写必填字段尝试新建测试用例，仍然复现相同异常
• 现象修正：经后续确认，进程并非完全死锁阻塞，而是以阻塞式状态运行、整体执行速度极慢

异常状态参考截图：

排查方向与对应解决方案 #

• 单次导入数据量超限
  Xray官方CSV导入单批次推荐上限为100条用例，超过阈值后，逐条例行权限校验、自定义字段合法性校验、索引同步操作会导致导入耗时指数级上升。处理方式：将CSV拆分为单批次50-100条的小文件分批导入，避免单次提交千条级以上数据。
• 测试步骤字段格式不兼容
  action、expected result字段如果包含未转义换行、冗余富文本标签、不可见特殊字符，导入过程会反复触发格式校验重试，大幅拖慢运行速度。处理方式：提前清理两个字段内的特殊符号、多余HTML标签，优先使用纯文本格式，避免直接复制粘贴富文本编辑器中的内容。
• Jira实例后台资源抢占
  Xray导入用例时会同步写入Jira issue索引，若实例后台存在正在运行的全量索引重建、其他批量操作任务，会抢占数据库连接资源导致导入请求排队阻塞。处理方式：联系Jira管理员查看后台任务队列，待其余批量任务执行完成后再发起导入。
• Xray插件版本兼容缺陷
  7.0之前的旧版本Xray存在CSV导入已知性能bug，更新已有测试用例时会重复查询关联的测试执行、测试计划数据，导致单条用例导入耗时可达数秒。处理方式：升级Xray插件到最新稳定版，或改用Xray官方REST API做批量更新，接口性能比CSV导入高5-10倍。
• 字段映射配置冗余
  若字段映射环节勾选了不需要更新的自定义字段，即便CSV中对应列为空，导入时也会逐条例行字段值校验，增加不必要的耗时。处理方式：精简字段映射配置，仅保留需要更新的action、expected result、description字段以及必填的标识字段，移除无关字段的映射关系。

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