如何解决Appium安卓测试运行时socket hang up报错问题

报错本质 #

Original error: Could not proxy command to the remote server. Original error: socket hang up
该报错的核心逻辑是Appium主服务与安卓设备端运行的UiAutomator2测试服务的TCP连接被意外中断，不属于版本不兼容、端口冲突、会话未正常退出类问题（你已经完成这三类场景的排查），结合容器化执行的场景，高频触发原因和对应解决方案如下：

• 容器权限与设备控制权冲突
  多数Appium镜像启动时默认未授予特权模式，也未正确挂载USB设备目录，若宿主机同时运行adb服务连接同一台测试设备，会出现双端adb抢设备控制权的问题，直接杀掉设备端运行的UiAutomator2进程触发断连。
  解决方式：启动Appium容器时追加--privileged参数，挂载宿主机/dev/bus/usb目录到容器同路径；容器启动后先执行adb kill-server && adb start-server确认设备识别正常，执行测试期间禁止宿主机adb服务连接同一台设备。
• Docker虚拟网络NAT超时断连
  Docker默认bridge网络模式存在默认300秒的TCP空闲连接超时规则，测试用例如果存在超过5分钟的等待、人工介入步骤，空闲连接会被Docker虚拟网关直接回收断开。
  解决方式：优先给容器加--net=host参数使用主机网络模式，跳过虚拟网络转发；如果必须使用bridge网络，给Appium启动参数追加--relaxed-security --command-timeout 3600，同时在UiAutomator2驱动配置中添加如下参数：

  {
    "uiautomator2ServerLaunchTimeout": 60000,
    "uiautomator2ServerInstallTimeout": 60000,
    "newCommandTimeout": 3000
  }
  

• Jenkins执行用户与容器内进程权限不匹配
  Jenkins默认使用uid为1000的jenkins用户执行任务，若容器以root用户启动，生成的adb密钥、会话临时文件权限不匹配，会导致UiAutomator2进程运行时无权限读写缓存，异常退出。
  解决方式：启动容器时通过--user 1000:1000参数指定和宿主机Jenkins用户一致的UID/GID，将容器内的安卓缓存目录（root用户为/root/.android，非root用户对应用户主目录下的.android文件夹）挂载到宿主机持久化，避免每次启动容器重新生成adb密钥触发设备重新授权。
• 容器资源不足触发OOM杀进程
  若Jenkins节点并行跑多个测试任务，未给Appium容器配置资源上限时，UiAutomator2服务占用内存超过cgroup默认限制会被系统直接杀掉，连接瞬间断开触发报错。
  解决方式：给每个执行测试的Appium容器分配至少2核CPU、4G内存，启动参数追加--memory=4g --cpus=2；在Jenkins节点配置中限制并行任务数，不要超过节点总可用资源的70%。
• Chromedriver与WebView版本不匹配
  测试包含混合应用H5操作场景时，即使Appium版本为最新，容器内置的Chromedriver版本和设备上的系统WebView/Chrome版本不匹配，切换上下文的瞬间就会断开UiAutomator2连接。
  解决方式：先查询测试设备上的WebView/Chrome大版本号，下载对应版本的Chromedriver放到容器内/usr/lib/node_modules/appium/node_modules/appium-uiautomator2-driver/node_modules/appium-chromedriver/chromedriver/linux/目录覆盖原有文件，启动Appium时通过--chromedriver-executable参数指定该驱动路径。

补充验证步骤 #

先跳过Jenkins，直接在启动的Appium容器内手动执行一个最简测试脚本：启动被测应用、等待10分钟、执行页面元素点击操作，确认无报错后再接入Jenkins流水线，排除Jenkins默认配置的子进程自动清理规则杀掉Appium相关进程的问题。

内容的提问来源于stack exchange，提问作者J.Klimov