Xcode真机调试时网页白屏怎么办？

卫华提问于 2026-03-26 18:04:21 阅读 32

移动

我用 Xcode 把 React 项目跑在 iPhone 真机上，本地开发服务器也开了，但一打开 Safari 就白屏，控制台也没报错。之前用模拟器没问题，换真机就挂了。

试过把 localhost 换成电脑的局域网 IP，也确认手机和电脑在同一网络下，还是不行。是不是要改什么配置？

我的 webpack dev server 启动命令是：

npx webpack serve --host 0.0.0.0 --port 3000

Xcode

我来解答赞 3 收藏

反馈

2 条解答

♫丽苹 Lv1

这个问题我也遇到过，烦死了。你试试这个办法吧。

首先确认你的 webpack 配置没问题，我猜你可能少加了个配置项。在 webpack.config.js 里加上这个：

devServer: {

    allowedHosts: 'all',

}

然后修改启动命令，加上 --disable-host-check 参数：

npx webpack serve --host 0.0.0.0 --port 3000 --disable-host-check

记得在 iPhone 上用 Safari 打开 http://你的电脑局域网IP:3000 而不是 localhost。如果还不行，检查一下手机网络是不是开了什么代理或者VPN，有时候这些也会影响连接。

真机调试就是坑多，祝你好运。要是还不行就只能慢慢排查了，反正我都快被这种问题搞秃了。

2026-03-31 09:09

IT人雯清 Lv1

真机调试遇到白屏确实挺烦人，前端这块得注意几个细节。首先你已经把 localhost 改成局域网 IP 是对的，但别忘了在 React 项目里也得同步修改。

打开你的 package.json 找到 homepage 字段，改成你电脑的局域网 IP 加端口，像这样：

"homepage": "http://192.168.x.x:3000"

另外记得在 webpack 配置里加个 devServer 的 allowedHosts 选项，允许所有主机访问：

module.exports = {

  // 其他配置

  devServer: {

    allowedHosts: 'all'

  }

}

还有个小坑就是 iOS 设备有时会缓存问题页面，改完配置后最好在 Safari 设置里清下缓存。要是还不行，试试在 iPhone 上直接输入完整 URL 访问看看。

这种问题经常搞得人头大，我以前也踩过不少类似坑，慢慢来总能解决。

2026-03-26 18:05