常见问题

未配置业务域名导致页面白屏

按元服务生态要求，AtomicServiceEnhancedWeb组件针对在线网页访问添加了域名校验，需要先完成业务域名配置，才可正常访问。

页面白屏时，可通过下面方法排查是否域名校验拦截导致：

• 在日志中搜索关键字：DomainControl：
  • checkUrl日志为h5页面的业务域名校验结果，ret=true代表业务域名校验通过，ret=false代表业务域名校验未通过。
  • checkUrlBlockList日志为页面请求的图片/css/js/接口等网络资源校验结果，ret=true代表校验通过，ret=false代表被全局域名黑名单拦截，豁免管控开关对该类域名不生效。

[ASCF Main]: DomainControl --> checkUrl -> ret=true url=https://www.example.com/
[ASCF Main]: DomainControl --> checkUrl -> ret=true url=https://www.example.com/
[ASCF Main]: DomainControl --> checkUrlBlockList -> ret=true url=https://www.example.com/example.css
[ASCF Main]: DomainControl --> checkUrlBlockList -> ret=false url=https://www.example.com/example.js

配置了业务域名页面还是白屏

按上面方法查看日志，过滤关键字DomainControl，检查是否被域名校验拦截。

被域名校验拦截：

• 检查访问的在线网页地址，只支持https协议，不支持http协议，不支持IP地址或localhost。
• 检查业务域名配置是否正确配置，包括：业务域名是否添加成功、是否已下载配置文件并放置到域名根目录下。
• 检查访问的在线网页地址域名前缀和配置的业务域名是否完全匹配。

未被域名校验拦截：

• 检查手机网络是否连通。
• 检查访问的在线网页地址是否可正常访问。
• 上面两项检查无误后，打开调试工具进行页面调试，检查是否页面js执行报错或页面网络请求失败。

本地调试如何跳过业务域名管控

访问rawfile下的本地网页，可以直接访问。

本地调试访问在线网页，若未配置业务域名，可以打开手机设置 -> 系统 -> 开发者选项 -> 开发中元服务豁免管控的开关，打开后可跳过业务域名校验，直接访问在线网页。

如果开启了元服务豁免管控后，网页请求还是失败，参考开启元服务豁免管控，元服务网络请求失败。

说明

元服务上架前，需先完成业务域名配置，否则无法正常访问在线网页。

h5网页报错了如何调试

参考元服务AtomicServiceEnhancedWeb如何调试前端页面。

ArkTS和h5如何实现双向通信

ArkTS到h5通信：

• 方式一：通过src传递参数。
• 方式二：实时消息通信，下个版本开始支持，敬请期待。

h5到ArkTS的通信：

• 方式一：通过路由传参。
• 方式二：实时消息通信，下个版本开始支持，敬请期待。

Web组件的runJavaScript()、registerJavaScriptProxy()无法使用

当前暂不支持，可通过ArkTS和h5如何实现双向通信中的方式实现。

自定义协议不支持

当前只支持以下自定义协议，其它自定义协议暂不支持。

• tel协议：唤起系统拨号界面。
• mailto协议：唤起系统默认邮件客户端。