React Native Expo App部分Wi-Fi网络下物理设备白屏问题排查求助

已知场景 #

• 模拟器运行完全正常，仅物理设备连接特定Wi-Fi（如健身房）时出现白屏，无崩溃或错误提示
• 自家Wi-Fi下物理设备测试无异常，连接问题Wi-Fi后开启VPN即可恢复正常
• 使用Expo未 eject，无法修改iOS/Android原生文件夹配置
• 所有API均为HTTPS且稳定运行多年，近期仅更新UI、升级React Native及一批依赖库

1. 优先排查网络请求阻塞 #

VPN能恢复正常，说明大概率是目标Wi-Fi的防火墙/路由规则拦截了某些请求：

• 启用Expo LogBox或集成远程日志工具（如Expo Logger），捕捉物理设备在问题Wi-Fi下的网络请求日志，重点关注：
  • App启动阶段的初始化请求是否超时、失败
  • 是否存在OPTIONS预检请求被拦截（HTTPS跨域场景下可能触发）
• 用物理设备的浏览器直接访问所有API地址，确认API本身是否能正常返回数据，排除API被路由拦截的可能
• 检查第三方依赖的隐藏请求（如统计、崩溃上报、字体加载服务等），这类非业务API更容易被Wi-Fi安全策略拦截

2. 排查RN/依赖库升级带来的配置变更 #

近期升级操作可能引入网络相关的默认配置变化：

• 对比升级前后的package.json，重点排查网络类依赖（如axios、fetch封装库、expo-network等）的版本差异
• 检查app.json中的Expo配置，比如iOS的infoPlist.NSAppTransportSecurity、Android的networkSecurityConfig，确认是否存在与HTTPS兼容的配置冲突
• 尝试降级React Native或可疑依赖库，逐步定位是否为某一升级项导致的问题

3. 排查物理设备与模拟器的网络栈差异 #

模拟器和物理设备的网络实现存在差异，可能触发路由的安全规则：

• 检查物理设备的Wi-Fi隐私设置：iOS关闭「私有地址」、Android关闭「随机MAC地址」，部分Wi-Fi会拦截使用隐私地址的设备请求
• 切换物理设备的Wi-Fi频段（2.4G/5G），部分路由对不同频段的拦截规则不同
• 测试不同品牌/系统的物理设备（iOS/Android），确认问题是否仅局限于某类设备，缩小排查范围

4. 排查Wi-Fi安全协议与证书问题 #

虽然API为HTTPS，但部分路由可能存在证书拦截或协议兼容问题：

• 检查物理设备是否安装了Wi-Fi强制推送的根证书，这类证书可能导致React Native的HTTPS请求验证失败（Expo默认严格验证证书，不建议随意关闭）
• 用expo-network获取当前Wi-Fi的安全类型（WPA2/WPA3），对比自家Wi-Fi的差异，部分旧设备对WPA3的兼容性较差
• 在代码中为所有HTTPS请求添加错误捕获（如fetch().catch(err => console.log(err))），打印详细错误信息，排查是否存在证书相关报错

临时用户解决方案 #

给受影响用户提供临时缓解方法：

• 建议连接VPN后使用App
• 建议切换Wi-Fi频段或使用移动数据

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