Xcodebuild提示RoutingHTTPServer未找到，WebDriverAgent构建安装失败求助

针对你在Mac OS 10.13.4 + Xcode 9.3 + Appium 1.7.2环境下碰到的WebDriverAgent构建失败、提示RoutingHTTPServer未找到的问题，我整理了几个经过验证的解决步骤，你可以逐一尝试：

1. 手动拉取WebDriverAgent的子模块 #

Appium自带的WebDriverAgent经常会出现子模块未完整拉取的情况，RoutingHTTPServer就是其中一个关键依赖。你可以手动补全：

• 先找到Appium安装路径下的WebDriverAgent文件夹，通常路径是：/usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
• 进入该文件夹后，执行以下命令：

  git submodule init
  git submodule update
  

  这会自动拉取所有缺失的子模块，包括你找不到的RoutingHTTPServer。

2. 检查Xcode项目的依赖配置 #

有时候Xcode不会自动识别子模块的依赖，需要手动确认：

• 打开WebDriverAgent的Xcode项目（WebDriverAgent.xcodeproj）
• 点击项目根节点，选择WebDriverAgentLib target，切换到Build Phases标签页
• 检查Link Binary With Libraries列表里是否有RoutingHTTPServer.framework，如果没有，点击+按钮，在弹出的窗口里找到并添加它
• 同样检查WebDriverAgentRunner target的Build Phases，确保依赖项配置正确

3. 清理Xcode缓存后重新构建 #

Xcode的缓存经常会导致依赖识别异常，清理后再试：

• 完全关闭Xcode
• 删除Derived Data文件夹，路径一般是：~/Library/Developer/Xcode/DerivedData
• 重新打开WebDriverAgent项目，选择你的真机设备，尝试重新构建

4. 再次确认代码签名配置 #

虽然你说已经遵循了真机设置教程，但还是再核对一遍签名配置，这也是常见的失败原因：

• 在Xcode中选中WebDriverAgentRunner target，切换到General标签页
• 确保Signing部分选择了正确的开发者账号，并且Automatically manage signing已经勾选
• 如果有红色报错，点击Fix Issue让Xcode自动处理签名问题

5. 用xcodebuild命令手动指定路径（可选） #

如果前面的步骤都无效，可以尝试直接用xcodebuild命令指定完整路径，强制识别子模块：

xcodebuild -project /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent/WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=你的设备UDID' test

补充：查看详细错误日志 #

如果还是失败，建议查看Xcode的详细错误日志定位问题：

• 构建失败后，点击Xcode顶部最右侧的Report Navigator图标
• 找到对应的构建记录，展开查看具体的错误详情，这能帮你发现更细节的问题

你提供的日志里显示The bundle “WebDriverAgentRunner” couldn’t be loaded，这通常和依赖缺失、签名错误或者架构不兼容有关，按照上面的步骤排查应该能解决问题。

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