Docker化React Native项目运行时无法连接宿主机模拟器该如何处理？

核心问题根因 #

1. ADB连接命令执行时机错误：Dockerfile中的RUN指令是镜像构建阶段执行的，构建阶段容器尚未启动，和宿主机模拟器的网络通路未建立，此时执行adb connect不会生效。
2. 环境变量名不匹配：Dockerfile中定义的RN打包服务环境变量为REACT_NATIVE_PACKAGER_HOST，但运行容器时传入的是REACT_NATIVE_PACKAGER_HOSTNAME，变量名不一致导致配置未生效。
3. ADB_IP配置错误：10.0.2.15是安卓模拟器内部访问宿主机的默认IP，不是容器访问宿主机模拟器的对应地址，按该值配置无法连通宿主机ADB服务。

排查步骤 #

• 进入运行中的容器手动验证连接：执行docker exec -it <容器ID> bash进入容器，先运行adb devices查看当前已连接设备，再手动执行adb connect <宿主机局域网IP>:5555查看连接报错信息。
• 验证网络连通性：在容器内执行ping <宿主机局域网IP>确认网络可达，再执行telnet <宿主机局域网IP> 5555验证ADB默认端口是否开放，不通的话需要排查宿主机防火墙或ADB网络调试配置。
• 验证环境变量传递：在容器内执行echo $ADB_IP、echo $REACT_NATIVE_PACKAGER_HOSTNAME确认配置已正确传入容器。

修复方案 #

1. 调整Dockerfile配置，修正执行时机与变量名，修改后示例如下：

FROM reactnativecommunity/react-native-android

LABEL version="0.0.1"

# 统一环境变量名，设置默认值，运行时可覆盖
ENV ADB_IP="127.0.0.1:5555"
ENV REACT_NATIVE_PACKAGER_HOSTNAME="172.17.0.2"

WORKDIR /app

COPY package.json .

RUN npm install

COPY . .

EXPOSE 19000
EXPOSE 19001
EXPOSE 5555

# 容器启动时先执行ADB连接，再启动RN服务
CMD sh -c "adb connect ${ADB_IP} && npm start"

2. 宿主机提前开启ADB网络调试，执行命令：

adb tcpip 5555

3. 调整运行命令，填入正确的ADB_IP：
   • Linux宿主机可直接使用host网络模式，无需端口映射，连接更稳定：

   docker build -t rn-android .
   docker run --net=host \
               -e ADB_IP=127.0.0.1:5555 \
               -e REACT_NATIVE_PACKAGER_HOSTNAME=127.0.0.1 \
               rn-android
   

   • Windows/Mac宿主机无法使用host网络，需填入宿主机的局域网IP（比如192.168.3.20），同时放开宿主机对应端口的防火墙限制：

   docker build -t rn-android .
   docker run -e ADB_IP=192.168.3.20:5555 \
               -e REACT_NATIVE_PACKAGER_HOSTNAME=192.168.3.20 \
               -p 19000:19000 \
               -p 19001:19001 \
               -p 5555:5555 \
               rn-android
   

4. 验证修复结果：容器启动后进入容器执行adb devices，可见已连接的模拟器设备即表示配置生效。

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