Appium+Webdriver.io+Mocha测试套件仅显示1个测试用例问题排查

我基于Appium、webdriver.io与Mocha创建了包含两个测试用例的测试套件，但运行测试时，测试运行器显示总测试数为1/1而非预期的2/2。

测试代码如下：

describe('News tests', () => {
  it('Creation of news', async () => {
    var newstab = await $('~NewsTab');
    await newstab.waitForDisplayed({timeout: 30000} );
    await newstab.click();
    var createnewbtn = await $('~create news button');
    await createnewbtn.waitForDisplayed({timeout: 30000} );
    await createnewbtn.click();
    var HeadlineField = await $('~headline input');
    await HeadlineField.waitForDisplayed({timeout: 30000} );
    await HeadlineField.addValue('Automated Test');
    var DeskField = await $('~description input');
    await DeskField.waitForDisplayed({timeout: 30000} );
    await DeskField.addValue('Automated Test description');
    var closebtn = await $('~close button');
    await closebtn.waitForDisplayed({timeout: 30000} );
    await closebtn.click();
 });
  it('Create new and cancel', async () => {
    var newstab = await $('~NewsTab');
    await newstab.waitForDisplayed({timeout: 30000} );
    await newstab.click();
    var createnewbtn = await $('~create news button');
    await createnewbtn.waitForDisplayed({timeout: 30000} );
    await createnewbtn.click();
    var closebtn = await $('~close button');
    await closebtn.waitForDisplayed({timeout: 30000} );
    await closebtn.click();
  });
});

可能的原因及解决办法 #

1. Mocha配置限制了测试执行 #

检查Mocha配置文件（如mocha.conf.js或.mocharc.json），或命令行运行参数，看是否添加了--bail选项——该选项会让Mocha在第一个测试失败后直接终止，不再执行后续用例。同时确认测试文件匹配规则是否正确，有没有只指定单个测试用例。

解决：移除--bail配置/参数，确保测试文件匹配规则能覆盖你的测试脚本。

2. 第一个测试用例抛出未捕获异常 #

如果第一个测试在执行中出现未被捕获的异步错误（比如元素查找超时、Appium连接中断），Mocha会直接终止整个测试套件，导致第二个用例无法运行。

解决：

• 给第一个测试的异步代码添加try/catch块，打印错误信息排查问题；
• 查看Appium服务日志，确认第一个测试执行时是否存在异常；
• 暂时注释第一个测试，单独运行第二个用例，验证其是否能被正常识别并执行。

3. WebdriverIO配置问题 #

检查wdio.conf.js配置：

• 确认specs选项是否正确指向包含两个测试用例的文件；
• 检查beforeTest、afterTest等钩子函数，看是否有代码抛出异常导致测试流程中断。

解决：修正specs路径，排查钩子函数中的错误逻辑。

4. 测试文件命名不符合Mocha默认规则 #

Mocha默认扫描test目录下的.js/.ts文件，如果你的测试文件不在该目录，或命名不符合规则，可能导致部分用例未被识别。

解决：将测试文件放到test目录，或在Mocha配置中指定正确的测试文件路径。

5. 异步操作未正确完成 #

虽然代码使用了await，但如果元素定位器错误（比如~NewsTab这个accessibility id不存在），或某个步骤超时后未正确处理，可能导致测试进程异常终止。

解决：验证所有元素定位器的正确性，确保每个await操作都等待到目标状态；可在关键步骤后添加日志输出，跟踪测试执行流程。

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