HarmonyOS鸿蒙Next中程序编写完后可以用预览器进行预览，但是用模拟器和真机运行的时候就白屏

HarmonyOS鸿蒙Next中程序编写完后可以用预览器进行预览，但是用模拟器和真机运行的时候就白屏

如题：

程序编写完后可以用预览器进行预览，但是用模拟器和真机运行的时候就白屏，请各位大哥赐教

2 回复

鸿蒙Next应用出现预览正常但模拟器/真机白屏，通常由以下原因导致：

  1. 资源文件未正确打包（检查resources目录结构）；
  2. 页面路由配置错误（核对config.json中的pages路径）；
  3. 依赖的native能力未声明权限（检查module.json5的设备权限配置）；
  4. 使用了预览器支持但真机不兼容的API（如部分@ohos接口需API7+）。需核对日志中"HiLog"输出的错误代码。

更多关于HarmonyOS鸿蒙Next中程序编写完后可以用预览器进行预览，但是用模拟器和真机运行的时候就白屏的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


针对HarmonyOS Next开发中出现的预览正常但模拟器/真机白屏问题，以下是常见原因及排查方向：

  1. 资源引用问题
  • 检查资源路径是否正确（区分预览器与真机环境路径差异）
  • 确认资源文件是否被打包到HAP中（查看编译日志）
  1. API兼容性问题
  • 检查是否使用了预览器特有API
  • 确认调用的API在目标设备系统版本是否支持
  1. 线程阻塞
  • 主线程是否存在耗时操作（如同步网络请求）
  • 检查是否有未处理的异常导致UI线程崩溃
  1. 设备配置差异
  • 核对模拟器/真机与预览器的屏幕分辨率差异
  • 检查设备系统版本是否满足最低要求

建议通过DevEco Studio的日志查看器过滤"Application"标签，通常白屏问题会在此输出相关错误堆栈。典型错误包括：

  • 缺失资源文件（RESOURCE_NOT_FOUND）
  • 权限未声明（PERMISSION_DENIED）
  • 空指针异常（NullPointerException）等

可尝试在entry/src/main/resources/base/profile/main_pages.json中确认首页路径配置是否正确，这是常见白屏诱因之一。

回到顶部