直播能看、商品却跳不过去？排查 WebView 域名与页面跳转
摘要： 微信小程序 WebView 里直播能播放，点击商品却无法进入自有商品页，通常需要沿“点击事件—H5 页面—微信环境—小程序路由—商品详情”逐段定位。
微信小程序 WebView 里直播能播放，点击商品却无法进入自有商品页，通常需要沿“点击事件—H5 页面—微信环境—小程序路由—商品详情”逐段定位。保利威标准观看页、自建 H5 入口和 Web SDK 自建观看页的事件控制权不同；先记录当前接入方式，再核对业务域名、JS-SDK 配置、页面路径和会员状态。
商品打不开时沿点击事件、实际域名、微信环境、小程序路由和订单归因逐段排查。
01 / 第一步：确认点击事件是否发出
在测试频道挂一件可用商品，记录频道 ID、商品 ID、点击时间和当前页面 URL。标准观看页先确认当前版本的商品跳转配置与目标类型；自建 H5 + Web SDK 则检查商品点击事件是否触发了企业的回调。若事件未发出，优先排查频道商品配置与前端事件绑定；若事件已发出但页面不动，继续查微信环境。
02 / 第二步：沿实际 URL 检查域名
检查小程序 <web-view> 初始地址、H5 跳转后的最终地址和可能的中转地址，逐一核对企业微信公众平台的业务域名配置。不要只查企业首页域名，活动页、自定义观看页或自定义域名也可能参与跳转。若页面使用微信 JS-SDK，再核对其对应的安全域名、签名 URL 与初始化状态。域名配置更改后使用目标 AppID 的体验版重新测试。
03 / 第三步：检查小程序页面路径
确认目标商品详情页已在当前包中注册，路径、参数名、商品 ID 和活动 ID 与 H5 约定一致。测试登录会员与未登录访客：未登录时应先完成授权或登录，再回到同一商品。返回按钮也应能回到直播间，避免用户落入多层 WebView 或失去观看状态。若通过中转页通信，记录每一跳的输入与输出参数。
04 / 第四步：排查播放与订单归因
商品页打开后检查直播音视频是否按设计停止或进入小窗。保利威小程序后台播放说明中，WebView 直播小窗经原生中转页，需验证返回 H5 时退出后台播放和声音状态。完成一笔测试订单后，在企业订单侧核对商品、会员、频道和活动来源；如果商品能打开却没有归因，问题通常位于参数传递或服务端订单关联。
05 / 形成可复现的问题单
问题单附 AppID 环境、iOS/Android 机型、微信版本、频道与商品配置、完整 URL 链、点击时间、预期路径、实际路径和屏幕录制。将问题定位为频道配置、H5 事件、域名/JS-SDK、小程序路由或订单归因，再由对应负责人修复。修复后从直播入口完整复测，不只重试商品按钮。
06 / 一个典型故障样例
活动页的 H5 在手机浏览器里能打开，进入小程序 WebView 后直播也正常；商品点击事件已触发，却在跳转时没有响应。例如实际观看页跳到另一个二级域名，而 JS-SDK 仍用初始 URL 签名，就需要沿该跳转链核对。修复应按项目的域名和签名规则处理，再检查商品路径与登录态。这个样例说明，故障点可能位于商品按钮之后的任意一跳。
07 / 修复后的回归范围
同一条商品链路至少用新会员和老会员各走一次，在 iOS、Android 上分别测商品详情、取消支付、支付完成和返回直播。若启用小窗，还需检查中转页是否退出后台播放。完成后再用门店分享卡片或课程入口测试来源参数，确保修复没有影响其他入口。
若企业希望长期减少 H5 与小程序之间的商品跳转层级，可评估保利威原生观看页 SDK；已有 uni-app 工程可通过 wxcomponents 接入 mp-weixin 观看组件，App 与 H5 使用对应端方案。具体路线见保利威开发者中心。
08 / 按症状定位，而不是反复点商品
从同一件测试商品出发，按“事件—域名—微信 JS-SDK—小程序路由—订单”依次取证。商品配置与接入方式不同，下面的症状用于缩小范围，不代表唯一原因。
| 看到的症状 | 下一步抓取证据 | 优先排查 |
|---|---|---|
| 商品卡没有点击反馈 | 商品 ID、频道商品配置、前端事件日志 | 商品未上架或回调未绑定 |
| 点击有日志但 WebView 不动 | 当前 URL、重定向链、业务域名清单 | 实际域名与后台配置不一致 |
| JS-SDK 报初始化或签名错误 | 签名 URL、初始化结果、安全域名 | 页面跳转后签名 URL 未同步 |
| 已调用跳转却未进商品页 | 目标页面路径、参数、登录状态 | 小程序路由或授权回流 |
| 商品页可打开但订单无来源 | 活动 ID、会员 ID、订单服务记录 | 参数传递或服务端归因 |
修复后使用新老会员分别完成“直播入口→商品→取消/完成支付→返回直播”，并检查小窗、声音和活动来源。
常见问题
浏览器打开商品页正常，为什么小程序里失败？ 小程序 WebView 还受业务域名、微信环境、JS-SDK 与小程序路由约束，应在体验版中按实际链路测试。
商品能跳转，是否就算修好？ 还需验证会员身份、订单来源、返回直播和播放状态。
问题单至少附哪些信息？ 附 AppID 环境、完整 URL 链、商品与频道配置、机型、时间和录屏。
延伸阅读
从本题继续推进，可阅读WebView 内嵌直播间怎么做？标准观看页、自建 H5 与 Web SDK 的接法和小程序直播上线检查清单：分享、商品跳转、埋点与返回路径。如需先看整体接入方式，参见微信小程序直播 SDK 选型总览；英文读者可使用本篇英文版。
关于保利威
保利威标准 H5 观看页、自建 H5 与原生观看页对应不同的商品事件和跳转责任。排障时先确认当前接入路径，再按开发者中心提供的相应接口与企业路由联调。
