Expo SDK40安卓端API报Network Error 如何配置明文流量？

核心配置：等效原生usesCleartextTraffic的实现 #

Expo 托管流程不需要手动修改原生AndroidManifest.xml，所有和Android系统级配置相关的参数都可以通过项目根目录的app.json声明式配置完成：

• 在app.json的expo.android配置块中新增usesCleartextTraffic属性，设置为true
• 具体配置片段参考：

{
  "expo": {
    "android": {
      "usesCleartextTraffic": true
    }
  }
}

该配置的作用和原生React Native项目中在AndroidManifest.xml根节点添加android:usesCleartextTraffic="true"完全一致，会解除Android 9（API Level 28）以上版本默认禁止明文HTTP流量的系统限制，从根源上解决该类拦截导致的网络异常。由于axios、fetch最终都会调用Android系统底层的网络接口，该规则生效后两类请求库会同步受管控，不需要单独针对某个请求库做兼容修改。

针对Let's Encrypt证书的特殊排查 #

由于你提到对接的API使用Let's Encrypt签发的SSL证书，即使配置了明文流量开关，部分场景下仍会出现请求超时返回Network Error的问题，这是Expo SDK40版本的常见兼容性问题：

• SDK40 内置的Android端网络信任库在2021年的证书过期事件后，已经移除了已失效的DST Root CA X3根证书，如果你的API服务仍在使用旧版证书链，会出现SSL握手失败、长时间无响应后抛出Network Error的情况
• 这类问题不属于明文流量拦截的范畴，需要在服务端更新证书链至ISRG Root X1的有效版本，或者在项目中自定义网络安全配置引入对应的根证书信任规则，单纯开启usesCleartextTraffic无法解决SSL层面的信任异常。

配置生效的注意事项 #

• 原生级别的配置修改无法通过JS热重载生效，修改完app.json后需要先停止现有Expo开发服务，执行npx expo start -c清除缓存，重新构建开发客户端后再测试请求
• 如果你是直接使用官方Expo Go应用调试，不需要手动开启该配置——Expo Go 从SDK33之后就已经全局默认开启了明文流量支持，这种场景下仍然报Network Error的话，可以直接优先排查证书链匹配问题。

参考错误截图：Network Error 示例

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