元服务加载H5页面白屏如何解决

问题现象

元服务加载H5显示白屏，无法加载出内容。

背景知识

元服务是HarmonyOS提供的一种轻量应用程序形态，具备服务直达、跨设备等特征。

元服务可独立上架、分发、运行，独立实现业务闭环，可大幅提升信息与服务的获取效率。

在元服务内，可使用AtomicServiceEnhancedWeb组件显示Web页面，且需要配置业务域名。

问题定位

元服务加载H5页面出现白屏时，大部分场景可以归结为域名、权限、混合内容或特殊字符四类问题。

1. 查看对应域名是否在AGC平台上配置。
2. 查看对应的网络权限是否配置。
3. 查看HTTPS页面里是否混用HTTP资源，判断是否需要开启混用功能。
4. 查看本地HTML或富文本是否含特殊字符，判断是否需经过base64编码后加载。

分析结论

1. 业务域名未配置或配置未生效。
2. 加载动画一闪而过，随后白屏，未配置网络权限。
3. HTTPS页面里混用HTTP资源，未开启混用模式。
4. 本地HTML或富文本含特殊字符，未做base64编码处理而直接加载。

修改建议

1. 参考配置业务域名配置正确的域名，域名配置默认24hours生效。可先在设置->应用和元服务->元服务中移除对应元服务，重新安装后域名配置立即生效。
2. 在module.json5中增加网络权限：ohos.permission.INTERNET。
3. AtomicServiceEnhancedWeb组件的mixedMode属性配置为MixMode.All，允许加载HTTP和HTTPS混合内容。
4. 把HTML先Base64编码，再加载。