WebdriverIO运行测试报错：browser对象未完全初始化无法加载spec文件

执行命令npx wdio run ./wdio.conf.js --spec addremovetests.js运行WebdriverIO测试时，抛出以下报错：

Unable to load spec files quite likely because they rely on browser object that is not fully initialised.
[0-0] browser object has only capabilities and some flags like isMobile.
[0-0] Helper files that use other browser commands have to be moved to before hook.

当前环境已知信息：

• logintests.js运行正常，其余测试文件运行均触发上述报错
• 已尝试修改页面对象引入路径const addremovePage = require('../pageobjects/addremove.page');，问题未解决
• wdio.conf.js核心配置：

specs: [
        './test/specs/**/*.js'
    ],
services: ['chromedriver'],

• package.json依赖版本：

"devDependencies": {
    "@wdio/cli": "^7.20.5",
    "@wdio/local-runner": "^7.20.5",
    "@wdio/mocha-framework": "^7.20.3",
    "@wdio/spec-reporter": "^7.20.3",
    "chromedriver": "^103.0.0",
    "wdio-chromedriver-service": "^7.3.2",
    "wdio-wait-for": "^2.2.6"
}

报错触发的核心逻辑是：测试文件或其递归引入的依赖文件，在Node.js模块加载阶段（即文件被require导入的顶层执行阶段）就调用了browser实例的命令，此时browser对象还未完成完整初始化，仅挂载了capabilities、isMobile等少量初始属性，调用其他API就会抛出该错误。

按优先级从高到低排查：

1. 对比正常运行的logintests.js与其依赖的页面对象，和报错用例的代码差异
   • 重点检查报错用例对应的页面对象文件（如addremove.page.js）：不要在文件顶层作用域、类的普通属性定义位置直接执行$()、$$()、browser.url()等依赖完整browser实例的调用。
   • 错误写法示例（加载文件时就会执行browser命令，直接触发报错）：

     // 文件顶层直接执行元素查询
     const addButton = $('#add-element')
     class AddRemovePage {
         // 类的实例属性直接写$()，实例化页面对象时（一般在文件顶层导出实例）就会执行查询，同样报错
         deleteButton = $('#delete-element')
     }
     module.exports = new AddRemovePage()
     

   • 正确写法（用getter定义元素，只有实际访问元素属性时才会执行查询，此时browser已经完成初始化）：

     class AddRemovePage {
         get addButton() { return $('#add-element') }
         get deleteButton() { return $('#delete-element') }
     }
     module.exports = new AddRemovePage()
     

2. 检查所有公共工具、自定义helper文件
   • 所有需要调用browser API的逻辑，禁止写在文件顶层，必须移到Mocha的before/beforeEach钩子、测试用例函数内部，或者页面对象的类方法中，确保执行时browser已经完成初始化。
3. 检查specs路径匹配范围
   • 当前配置的./test/specs/**/*.js会递归匹配specs目录下所有js文件，确认有没有误把页面对象、工具脚本放到specs目录下被当成测试文件加载，这类非测试文件如果在顶层调用browser API，也会触发相同报错。

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