如何解决无法连接Appium服务器的问题

错误提示：
Could not connect to Appium server URL 'http:// 127.0.0.1:4723/wd/hub'. Please check if the server is running and the URL is correct (valid URLs can be found at the start of the Appium server log). If you are using the Inspector's browser version, ensure the server has been started with '--allow-cors'.

已确认操作：

• Appium服务器已在127.0.0.1:4723启动
• 已添加--allow-cors启动参数

排查步骤 #

1. 修复URL中的空格 #

错误提示里的URL http:// 127.0.0.1:4723/wd/hub 在http://和127.0.0.1之间多了一个空格，这是无效的URL格式。检查你的连接配置，把空格删掉，改用http://127.0.0.1:4723/wd/hub。

2. 验证端口监听状态 #

• Windows：打开命令提示符执行 netstat -ano | findstr ":4723"，确认4723端口是否被Appium进程占用。
• macOS/Linux：在终端执行 lsof -i :4723 或 netstat -tulpn | grep 4723，检查Appium是否正常绑定该端口。

3. 核对服务器日志里的有效URL #

启动Appium时，日志开头会显示服务器实际监听的地址，确认这个地址和你使用的连接URL一致。比如有些服务器会绑定到0.0.0.0:4723，用127.0.0.1也能访问，但如果日志里有自定义路径或端口，要对应调整。

4. 用curl测试基础连接 #

执行以下命令测试服务器是否能正常响应：

curl http://127.0.0.1:4723/wd/hub/status

如果返回JSON格式的状态信息，说明服务器正常；如果连接失败，检查防火墙或杀毒软件是否拦截了4723端口。

5. 检查Inspector和服务器版本兼容性 #

如果你用的是浏览器版Appium Inspector，确认它和Appium服务器的版本是否匹配。版本不匹配经常会导致CORS或连接问题，尝试把两者升级/降级到稳定兼容的版本。

6. 彻底重启服务 #

完全关闭Appium服务器和Inspector，杀掉所有残留进程后重新启动。有时候后台残留进程会导致连接异常，即使你以为服务器已经正常运行。

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