更新时间：2025-04-21 14:15:20收藏订阅更新我的文档设置返回文档简介使用 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 主文档域名，可以全都加上）。如果页面还有后续跳转、可能涉及到不同域名，请确保将后续页面相关域名也加入配置。 5填写内嵌h5页面的具体使用场景，h5域名地址及页面截图，有助于审核通过。 注意：填写的域名地址打开页面内容须和页面截图保持一致，以免审核驳回。错误码当发生错误时，且支付宝客户端版本在 10.2.73 以上，错误码会在页面中直接显示，例如：错误码原因凯发app官方网站的解决方案040001001render域名中不能包含alipays的域名。web-view 要渲染的 h5 网页 url ，默认允许打开所有 https://render.alipay.com/p/ 开头的 url且不包含alipays的域名（支付宝客户端 10.2.63 版本开始支持），其他网页需要在 > 对应小程序详情页 > 开发设置 > h5域名配置 进行 h5 域名白名单配置。说明：src必须是标准的 h5 链接，任何包含例如 alipays://xx... 的链接都会导致重定向出错，从而无法展示页面，即使是 https://render.alipay.com 开头的 url 也不能包含 alipays://xx...此类内容。040001002scheme 不是 alipay、http 或 https, 禁止跳转。请检查 url scheme 是否符合规范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 权限。
