Expo Go无法连接本地HTTPS Uvicorn/FastAPI服务器,iOS资源加载遇阻
解决方案
1. 修正Uvicorn绑定配置与证书生成
- 启动Uvicorn时必须绑定
0.0.0.0,确保局域网内设备(包括iOS模拟器)能通过电脑的局域网IP访问,命令示例:uvicorn main:app --host 0.0.0.0 --port 8432 --ssl-keyfile ./key.pem --ssl-certfile ./cert.pem - 生成自签名证书时,将
Common Name设为你的局域网IP(如192.168.1.56),避免域名不匹配错误,生成命令:openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes -subj "/CN=192.168.1.56"
2. 在iOS模拟器中信任自签名证书
- 将生成的
cert.pem文件拖入iOS模拟器窗口,按照提示完成证书安装。 - 进入模拟器「设置」→「通用」→「关于本机」→「证书信任设置」,找到对应证书并开启「信任」开关。
3. 调整Expo项目配置与请求地址
- 所有请求必须使用电脑的局域网IP(如
https://192.168.1.56:8432),iOS模拟器的localhost指向自身,无法访问电脑本地服务。 - 在项目
app.json中添加iOS安全配置(仅用于开发环境):{ "expo": { "ios": { "infoPlist": { "NSAppTransportSecurity": { "NSExceptionDomains": { "192.168.1.56": { "NSIncludesSubdomains": true, "NSExceptionAllowsInsecureHTTPLoads": false, "NSExceptionRequiresForwardSecrecy": false } } } } } } }
4. 快速替代方案:用ngrok转发HTTPS流量
- 若本地证书配置仍有问题,使用ngrok将本地HTTP服务转为受信任的HTTPS公网地址:
ngrok http 8432 - 将Expo请求地址替换为ngrok提供的HTTPS域名(如
https://xxxx-xx-xx-xx-xx.ngrok.io),无需处理自签名证书信任问题。
验证步骤
- 电脑浏览器访问
https://192.168.1.56:8432/docs,确认Swagger正常加载(若有证书警告则手动信任)。 - iOS模拟器的Safari访问同一地址,能正常打开则说明证书信任生效,Expo Go可正常发起请求。
内容的提问来源于stack exchange,提问作者yavuzakyazici
相关产品推荐
相关产品推荐

