uniapp 真机白屏问题如何解决？

UniApp 真机白屏是常见问题，通常由以下原因导致。请按顺序排查：

1. 基础排查

• 检查运行模式：确认使用 发行模式（生产环境）运行，开发模式在真机可能异常。
• 重新运行：尝试卸载 App，重新 npm run dev 或 npm run build。

2. 路由与页面配置

• 确保 pages.json 中首页路径正确：

  {
    "pages": [
      {
        "path": "pages/index/index",
        "style": { ... }
      }
    ]
  }
  

• 若使用分包，检查 subPackages 路径是否准确。

3. 资源加载问题

• 静态资源路径：使用 @/ 或相对路径，避免绝对路径。
• 图片/字体过大：压缩资源，或使用网络路径。

4. JS 错误

• 检查控制台：在 HBuilderX 中查看真机调试日志，修复语法或逻辑错误。
• 常见问题：
  • API 调用兼容性（如 uni 接口）。
  • V3 引擎适配：在 manifest.json 中尝试切换老版引擎。

5. 应用配置

• AppID 校验：若用微信小程序等平台，检查 manifest.json 中 AppID 是否正确。
• 权限设置：Android 需开启网络等权限。

6. 平台特定问题

• Android：检查 CPU 架构适配（arm64-v8a 等）。
• iOS：确认证书和描述文件有效。

快速解决步骤：

1. 发行模式重新编译。
2. 查看 HBuilderX 控制台错误信息。
3. 检查 pages.json 和静态资源。
4. 简化页面代码，排查组件兼容性。

若仍无法解决，提供具体错误日志以便进一步分析。