You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native运行npm start异常:未生成二维码仅显示操作提示

React Native启动无二维码仅显示重载提示的排查方案

我来帮你梳理下这个常见问题的可能原因和解决办法:

  • Metro服务器网络绑定异常
    有时候Metro默认只绑定到localhost,导致无法生成局域网可访问的二维码。你可以手动指定启动参数让它绑定到所有网络接口:

    npm start -- --host 0.0.0.0
    

    同时检查下电脑防火墙有没有拦截Metro的默认端口8081,确保端口能正常被局域网设备访问。

  • 终端环境不支持二维码渲染
    要是你用的是老旧终端、无图形界面的SSH会话或者某些轻量终端工具,可能没法显示二维码。这种情况可以:

    • 换个主流终端(比如Mac用iTerm2,Windows用PowerShell)重新启动;
    • 手动在设备上输入Metro地址:模拟器用localhost:8081,真机用电脑的局域网IP+端口(比如192.168.3.10:8081)。
  • Metro配置被修改禁用了二维码
    检查项目根目录的metro.config.js,看看有没有自定义配置拦截了二维码生成逻辑。如果有修改过相关配置,尝试恢复默认配置,或者调整配置项重新启用二维码功能。

  • 缓存或版本兼容问题
    缓存冲突或者CLI版本bug也可能导致这个问题。先试试清除Metro缓存再启动:

    npx react-native start --reset-cache
    

    如果还是不行,可以考虑更新React Native CLI到最新稳定版,或者回退到之前能正常运行的版本。

  • 设备与电脑不在同一局域网
    确保你的开发手机/模拟器和电脑连接的是同一个Wi-Fi网络,检查电脑的局域网IP是否正常分配(可以用ipconfig(Windows)或ifconfig(Mac/Linux)查看)。

内容的提问来源于stack exchange,提问作者jayzee

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.09 12:02:42