uniapp 小米手机调试不显示是什么原因

我在使用uniapp开发时，遇到小米手机调试不显示内容的问题。其他安卓手机和iOS都正常，只有小米手机调试时页面空白，控制台也没有报错。已经尝试过清除缓存、重启手机和重新安装应用，问题依旧存在。请问有人知道是什么原因导致的吗？如何解决这个问题？

2 回复

小米手机调试不显示，可能是以下原因：

  1. 未开启USB调试：在开发者选项中打开。
  2. 驱动问题：检查USB驱动是否正常。
  3. 未授权：连接时手机弹出授权提示，需允许。
  4. 数据线问题：换原装数据线试试。

在UniApp开发中，小米手机调试时页面不显示，通常由以下原因导致。请按顺序排查：

  1. 开发者选项未开启 USB 调试

    • 进入「设置」>「关于手机」，连续点击「MIUI 版本」7次开启开发者模式。
    • 返回「设置」>「更多设置」>「开发者选项」，开启「USB 调试」和「USB 安装」。

  2. 未授权 USB 调试权限

    • 首次连接时，手机端会弹出「是否允许 USB 调试」对话框，勾选「始终允许」后确认。

  3. HBuilderX 未检测到设备

    • 在 HBuilderX 中，点击「运行」>「运行到手机或模拟器」>「运行到 Android App 基座」。
    • 若设备列表中无手机，尝试重新插拔 USB 线或更换数据线（推荐原装线）。

  4. 端口被占用或驱动问题

    • 关闭电脑上的手机助手类软件（如小米手机助手）。
    • 在开发者选项中关闭「MIUI 优化」后重试。
    • 卸载旧驱动，安装最新小米 USB 驱动。

  5. UniApp 本地端口冲突

    • 在 HBuilderX 中修改调试端口：「运行」>「运行到手机或模拟器」>「设置 Android 调试端口」，改为 8081 等未占用端口。

  6. 手机网络与电脑不在同一网段

    • 若使用无线调试，确保手机和电脑连接同一 WiFi。
    • 在 HBuilderX 中运行到「内置浏览器」，扫码测试页面是否正常，排除代码问题。

  7. 系统权限限制（小米系统常见）

    • 进入「手机管家」>「应用管理」>「权限」>「USB 安装管理」，确保 HBuilder/HBuilderX 被允许安装。
    • 关闭「网络助手」中的流量提醒，避免拦截调试数据。

  8. 基座版本不匹配

    • 在 HBuilderX 中重新制作自定义基座：「运行」>「运行到手机或模拟器」>「制作自定义基座」。

若以上步骤无效，尝试重启手机和电脑，或换一台小米手机测试。多数情况通过开启 USB 调试和授权即可解决。

回到顶部