uniapp 安卓白屏

问题分析

Uniapp开发的安卓应用出现白屏问题通常由多种原因导致，包括资源加载失败、启动页配置错误、渲染异常或原生层兼容性问题。以下是常见排查和解决方法：

检查启动页配置

确保manifest.json中启动页配置正确，避免因路径错误导致白屏。检查以下配置项：

{
  "app-plus": {
    "splashscreen": {
      "autoclose": true,
      "waiting": true,
      "delay": 0
    }
  }
}

若启动页图片过大或格式不兼容（如非PNG），可能导致加载失败。建议图片尺寸控制在1MB以内。

基础库版本兼容性

部分白屏问题源于Vue或Uniapp基础库版本冲突。升级到最新稳定版HBuilderX，并在package.json中锁定依赖版本：

"dependencies": {
  "@dcloudio/uni-app": "^3.0.0",
  "vue": "^2.6.14"
}

原生层权限问题

安卓6.0+需要动态申请存储权限，否则可能导致资源加载失败。在AndroidManifest.xml中添加权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

通过uni.authorize在运行时申请权限：

uni.authorize({
  scope: 'scope.writeStorage',
  success: () => console.log('授权成功')
});

渲染层优化

页面元素过多或复杂计算可能导致渲染超时。通过以下方式优化：

• 使用v-if替代v-show减少初始DOM节点
• 避免在onLoad中同步执行耗时操作
• 分页加载长列表数据，使用uni.$on传递数据

调试工具使用

通过adb logcat查看原生层日志：

adb logcat | grep -E "WebConsole|uniapp"

在HBuilderX中开启调试模式，检查控制台是否有资源404或JavaScript异常。

分包加载失败处理

若使用分包加载，需确认subPackages配置正确。检查pages.json：

{
  "subPackages": [
    {
      "root": "subpackage",
      "pages": [
        {"path": "index", "style": {}}
      ]
    }
  ]
}

主包体积超过2MB可能导致分包加载失败，需通过压缩图片或移除冗余组件优化。

其他解决方案

• 清除应用缓存或重新安装APK
• 测试不同安卓版本设备（如4.4/8.0/11.0）
• 使用标准模板新建页面，逐步排查业务代码影响

若问题仍未解决，可提供具体复现步骤和设备信息进一步分析。