执行appium -allow-cors报错网页版Appium Inspector无法使用如何解决

算力阿峰

2026-8-29

解决方法

核心报错原因90%以上是启动参数格式错误，按以下步骤逐一排查即可：

修正CORS启动参数
Appium 2.x（当前主流正式版本）的长参数必须使用双横杠前缀，旧教程里写的单横杠-allow-cors是1.x版本的废弃语法，2.x版本无法识别会直接抛出参数错误。
正确启动命令：
```
appium --allow-cors
```
可以先执行appium --version确认本地版本：如果返回版本号是2.x开头，直接用上面的双横杠命令即可。
排查端口占用问题
如果修正参数后仍然启动失败，优先检查Appium默认的4723端口是否被残留进程占用：
- Windows系统执行以下命令查找占用进程：
```
netstat -ano | findstr :4723
```
  拿到返回结果最后一列的PID数字，执行taskkill /PID 替换成你的PID号 /F 强制杀掉残留进程后重新启动。
- Mac/Linux系统执行以下命令查找占用进程：
```
lsof -i :4723
```
  拿到返回结果里的PID数字，执行kill -9 替换成你的PID号 杀掉残留进程后重新启动。
启动成功校验
终端输出Appium REST http interface listener started on 0.0.0.0:4723字样即代表服务正常运行，此时再打开网页版Appium Inspector，连接参数填写本地127.0.0.1、端口4723、路径为/即可正常连接，不会触发跨域拦截。