Quantum+Cucumber+TestNG随机出现‘TestStep implementation not found’问题咨询

我正在基于Perfecto Quantum构建移动自动化框架，该框架基于QAF + Cucumber 1.2.5 + TestNG 6.10开发。测试执行中会随机出现部分测试失败，报错信息如下：

TestStep implementation not found.
Please provide implementation or ensure 'step.provider.pkg' property includes appropriate package.

环境配置 #

• Quantum版本：1.22.0
• 执行方式：通过BAT文件执行testng.xml测试套件
• 共享配置（env.properties）：

step.provider.pkg=com.quantum.steps

需说明的是，该问题为无规律偶发情况，且所有步骤均已正确实现。

请问为何配置正确仍会偶尔找不到步骤实现？这是否为Quantum或QAF已知的时序/懒加载/类路径缓存问题？有何稳定步骤加载的建议？

可能的原因 #

1. 类加载时序与竞态条件：多线程并行测试场景下，QAF的步骤扫描逻辑存在线程安全隐患，当多个线程同时触发步骤加载时，可能导致部分步骤类未被完整扫描就开始执行测试，出现偶发的找不到实现的情况。Quantum基于QAF扩展，继承了这一潜在问题。
2. 类路径缓存与JVM残留：通过BAT脚本执行时，若前一次测试的Java进程未完全销毁，残留的类加载器缓存会干扰新测试的类加载，导致步骤类无法被正确识别。
3. 版本兼容问题：Quantum 1.22.0与Cucumber 1.2.5、TestNG 6.10的组合存在未修复的步骤加载时序缺陷，后续版本针对并行场景的扫描逻辑做了优化。

稳定步骤加载的建议 #

• 强制预加载步骤类：在测试套件启动前添加初始化逻辑，通过自定义TestNG监听器调用com.qmetry.qaf.automation.step.StepFactory.init()方法，确保所有步骤类在测试执行前完成扫描与加载。
• 调整并行执行策略：避免使用parallel="methods"细粒度并行，改用parallel="tests"或parallel="classes"模式；同时根据机器性能合理设置thread-count，减少线程竞争。
• 清理残留进程：在BAT执行脚本开头添加进程清理逻辑，比如：

taskkill /f /im java.exe

确保每次测试都启动全新的JVM实例，规避类路径缓存问题。

• 升级框架版本：将Quantum升级到1.25及以上版本，同步升级QAF至对应兼容版本，新版本修复了多个并行场景下的步骤加载问题。
• 显式指定步骤类：在env.properties中补充step.impl.classes属性，直接列出所有步骤实现类，绕过包扫描逻辑：

step.impl.classes=com.quantum.steps.LoginSteps,com.quantum.steps.HomeSteps,com.quantum.steps.CheckoutSteps

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