真机白屏先分清 Debug 包与证书

更新于 2026-07-05

**iOS 真机装上 App 却打不开/白屏/闪退，先别怀疑业务代码。两个最平凡的原因：一是证书没被手机信任（iPhone 拦截），二是装的是 Debug 包。**

Debug 包的坑

Debug 包不内置完整 JS，打开后会去开发机找 Metro dev server。默认地址是 localhost:8081——真机上的 localhost 是手机自己，不是 Mac，所以必然连不上。

  • 让 Metro 监听局域网：以 --host lan 启动，手机通过 Mac 局域网 IP 访问。
  • 或打 Release 包，让 App 不依赖 Metro、像普通 App 一样直接打开。

判断顺序

  1. 证书是否已被信任
  2. 装的是 Debug 还是 Release
  3. 若是 Debug：Metro 是否在跑、地址是否可达

相关