WDIO执行Android自动化测试时无法创建会话：连接localhost:4723失败

问题场景 #

执行npm run android.app命令运行Android自动化测试时，WDIO通过WebDriver协议尝试连接http://localhost:4723创建会话，触发connect ECONNREFUSED ::1:4723错误，导致测试用例/test/specs/android/arive.e2e.ts执行失败，最终生成Allure报告。

排查与解决步骤 #

• 确认Appium服务状态
  在终端执行appium命令启动服务，确认服务正常运行在localhost:4723。启动成功后会输出类似Appium REST http interface listener started on 0.0.0.0:4723的日志。
• 修正WDIO连接配置
  打开WDIO配置文件（如wdio.conf.ts），检查hostname和port参数：
  • 若本地IPv6解析存在异常，可将hostname从localhost改为127.0.0.1，规避IPv6本地回环地址::1的连接问题
  • 确保port值与Appium服务监听端口一致（默认4723）
• 检查端口占用
  • Mac/Linux系统执行：lsof -i :4723
  • Windows系统执行：netstat -ano | findstr :4723
    若4723端口被其他进程占用，可停止占用进程，或启动Appium时指定新端口（如appium --port 4724）并同步更新WDIO配置的端口值
• 验证防火墙规则
  暂时关闭本地防火墙，测试是否能正常连接Appium服务。若关闭后恢复正常，需在防火墙中添加4723端口的允许规则。

内容的提问来源于stack exchange，提问作者Bhupendra Singh Rautela