更新时间：2025-01-02 18:15:11收藏订阅更新我的文档设置返回文档简介使用 web-view h5 页面承载组件 需要对要访问的 url（主文档 url、iframe 里的主文档 url，以及后续跳转的主文档 url）进行白名单配置，本文主要描述相关配置流程。web-view 相关的其他问题，详情可查看 web-view 常见问题 。h5 中引用到的静态资源不需要设置域名白名单。使用限制●只能添加备案过的域名，且该域名已经指向有效的、可控（能放置文件到域名根目录）的服务器。●h5 域名配置变更后需要小程序发版，新的配置仅对新版小程序生效。●配置的域名要求外网访问 http 状态码必须为 200。使用1登录 进入对应小程序开发设置页面。 说明： 若是三方场景为小程序模板设置 h5 域名配置，需登录 开放平台控制台 进入对应小程序模板详情页面进行配置。 2点击 h5 域名配置 中的 添加。 3点击 下载校验文件，获取校验文件并放置在配置域名根目录下。nginx 的域名根目录可从配置文件中看到。 4输入域名地址，格式为 https://your-domain-name， 点击 点击这里 确认验证文件可以正常访问。如果配置正确，则校验通过。通过后点击 确定，即完成白名单配置。 注意： 可使用 chrome 打开目标 h5 页，按 f12 键，进入 source 面板查看页面用到的相关域名（如不能区分哪些是主文档/iframe 主文档域名，可以全都加上）。如果页面还有后续跳转、可能涉及到不同域名，请确保将后续页面相关域名也加入配置。 错误码当发生错误时，且支付宝客户端版本在 10.2.73 以上，错误码会在页面中直接显示，例如：错误码原因凯发app官方网站的解决方案040001001/040001008宿主小程序配置了 webviewscheme 跳转黑名单，禁止跳转。请联系支付宝凯发app官方网站的技术支持解决040001002scheme 不是 alipay、http 或 https, 禁止跳转。请检查 url scheme 是否符合规范040001003淘宝 webview 配置管控，无访问权限。请联系淘宝业务人员申请权限040001004/040001005/040001006未配置 h5 域名白名单，请进行配置。未配置 h5 白名单，请进行配置或检查配置文件是否生效。040001007开启了强制 ssl，http 请求无权限。请自行规避在开启强制 ssl 的情况下访问 hhtp 请求040001009内嵌页通过 src 方式触发 alipays://，但 url 不是 startapp 标准格式，无访问权限。请检查请求的 url 开头是否符合以下规则： ●alipays://platformapi/startapp●alipay://platformapi/startapp●alipays://platformapi/startapp●alipay://platformapi/startapp040001010webview 触发 startapp, 但 appid 为空，直接进入错误页。请检查触发 startapp 的 url 中是否带有小程序 appid。040001011内嵌 webview 无 startapp 权限。无 startappjsapi 权限。
