Docker化Expo React Native应用无法刷新代码变更问题排查

我正在将Expo React Native应用Docker化，目标是让团队成员拉取代码后通过docker-compose up快速启动一致的Expo服务。但目前遇到代码变更无法同步到Expo Go的问题——已确认容器内文件已更新、Expo Go已开启Fast Refresh、本地运行时刷新功能正常，因此问题大概率出在Docker配置上。

当前配置文件 #

Dockerfile #

FROM node:latest

RUN mkdir -p /usr/src/app

WORKDIR /usr/src/app

COPY package*.json /usr/src/app/
COPY app.json /usr/src/app/

RUN npm install -g expo-cli

EXPOSE 8081
EXPOSE 19000
EXPOSE 19001
EXPOSE 19002

CMD npm i -f && npm start

docker-compose.yml #

version: '3.8' # Specify Compose file format version
services:
   expo: # Name of the frontend service
      container_name: expo-container
      build: ./ # Specify the directory of the Dockerfile
      ports:
         - 8081:8081 # Specify port-forwarding
         - 19000:19000 
         - 19001:19001
         - 19002:19002
      volumes: # Mount host path in the container
         - ./:/usr/src/app
         - /usr/src/app/node_modules
      environment:
         - EXPO_DEVTOOLS_LISTEN_ADDRESS=0.0.0.0 
         - REACT_NATIVE_PACKAGER_HOSTNAME=192.168.0.2

问题原因分析 #

核心问题在于Docker挂载卷的文件系统事件无法被Expo的Metro打包器自动检测到：默认情况下Metro依赖文件系统的inotify事件，但Docker挂载的卷在多数环境下不会传递这些事件，导致Fast Refresh无法触发。此外，部分环境变量配置未完全适配容器化场景。

解决方案 #

1. 添加文件监听轮询环境变量 #

在docker-compose.yml的environment中添加强制轮询的配置，让Metro主动检测文件变化：

environment:
   - EXPO_DEVTOOLS_LISTEN_ADDRESS=0.0.0.0 
   - REACT_NATIVE_PACKAGER_HOSTNAME=192.168.0.2
   - CHOKIDAR_USEPOLLING=true
   - CHOKIDAR_INTERVAL=1000 # 可选，调整轮询间隔，默认1000ms

2. 优化Dockerfile启动命令 #

移除CMD中的npm i -f，避免每次启动容器都强制安装依赖（依赖安装应在构建阶段完成，首次启动若需补全依赖可手动执行）：

CMD ["npm", "start"]

3. 确认宿主机IP配置 #

确保REACT_NATIVE_PACKAGER_HOSTNAME设置的是宿主机的实际局域网IP，而非容器内部IP，Expo Go需要通过这个IP访问Metro服务器。如果团队成员宿主机IP不同，可启动时通过环境变量动态覆盖：

REACT_NATIVE_PACKAGER_HOSTNAME=$(hostname -I | cut -d' ' -f1) docker-compose up

4. 修复文件权限问题 #

在Dockerfile中切换到非root用户运行，避免挂载卷的权限冲突：

FROM node:latest

RUN mkdir -p /usr/src/app

WORKDIR /usr/src/app

COPY package*.json /usr/src/app/
COPY app.json /usr/src/app/

RUN npm install -g expo-cli

# 切换到node用户，避免权限问题
USER node

EXPOSE 8081
EXPOSE 19000
EXPOSE 19001
EXPOSE 19002

CMD ["npm", "start"]

验证修改 #

修改配置后执行以下步骤：

• 停止并删除现有容器：docker-compose down
• 重新构建镜像：docker-compose build --no-cache
• 启动服务：docker-compose up
• 修改本地代码，观察Expo Go是否自动刷新

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