Expo开发构建问题:Fast Refresh失效且控制台日志不显示
EAS开发构建中Fast Refresh失效、控制台日志不显示的排查方案
针对安卓物理设备上EAS开发构建出现的Fast Refresh失效、控制台无日志问题,做以下排查和修复:
1. 确认构建配置与环境
- 检查
eas.json的development配置段,确保包含"developmentClient": true,保证构建的是支持开发功能的客户端包 - 构建时必须指定开发profile:执行
eas build --profile development --platform android,避免误用到生产环境的构建配置
2. 修复设备与开发服务器的连接
- USB连接场景:
- 确保设备开启「USB调试」和「USB网络共享」(部分品牌设备需手动开启)
- 执行
adb reverse tcp:8081 tcp:8081,完成端口映射后再启动npx expo start
- WiFi/隧道场景:
- 同一WiFi下优先用
npx expo start --lan,检查电脑防火墙是否允许Expo的8081/19000端口通行 - 隧道模式下,关闭本地防火墙或添加ngrok的放行规则,避免流量被拦截
- 同一WiFi下优先用
3. 检查项目核心配置
- 打开
app.json或app.config.js,确认expo.developmentClient.enabled设为true,这是开发客户端启用热重载的必要配置 - 暂时移除项目中非必要的第三方原生插件,排查是否有插件干扰了Fast Refresh的逻辑
4. 清理缓存重置状态
- 清理本地Expo缓存:
npx expo start --clear - 卸载设备上的旧开发构建包,重新安装最新构建的APK
- 清理EAS远程构建缓存:
eas build --clear-cache后重新执行构建
5. 日志定位问题
- 启动项目时加 verbose 参数:
npx expo start --verbose,查看本地控制台是否有设备连接失败的报错信息 - 用
adb logcat *:S ReactNative:V ReactNativeJS:V抓取设备端原生日志,定位是否存在初始化或连接类的异常
内容的提问来源于stack exchange,提问作者ethanworker
相关产品推荐
相关产品推荐

