uni-app 中 web-view 调用 H5 JS 函数只能通过 window.postMessage 实现，H5 需监听 message 事件并校验 origin；uni-app 端用 webviewRef.postMessage（App/小程序），H5 平台需改用 URL Hash 或 localStorage 中转。
uni-app 里 web-view 怎么调用 H5 页面里的 JS 函数？
不能直接调用。uni-app 的 web-view 是个独立渲染容器，js 上下文完全隔离，window.postmessage 是唯一可行通路。
H5 页面必须主动监听 message 事件，并校验来源（event.origin），否则会被跨域拦截或恶意注入：
- H5 页面需在
mounted或DOMContentLoaded后注册window.addEventListener('message', ...) - uni-app 端必须用
webviewRef.postMessage()（仅 App 和小程序支持），H5 平台不支持该 API，此时要改用 URL 参数或 localStorage 中转 - App 平台（iOS/Android）中，
postMessage传对象会自动序列化，但某些老版 WebView 会丢掉函数和 undefined 字段
H5 页面怎么把数据发回 uni-app？
靠 window.webkit.messageHandlers.uniApp.postMessage()（iOS）和 WebViewJavascriptBridge（Android），但 uni-app 封装了统一入口：uni.postMessage()。
这个 API 只在 web-view 加载完成后的 H5 页面中有效，且依赖原生层桥接。常见失效原因：
-
uni.postMessage调用时机太早，H5 还没加载完，uni对象未注入 → 放在document.readyState === 'complete'后或setTimeout延迟 100ms - 微信小程序里，
web-view必须是同域（或已配置业务域名），否则uni对象根本不会挂载 - App 端若使用自定义基座，需确认
uni-app原生插件已启用，否则uni.postMessage是 undefined
为什么 postMessage 在 H5 平台总收不到回调？
因为 H5 平台的 web-view 实际就是个普通 iframe，uni-app 没有注入任何桥接脚本，uni.postMessage 根本不存在。
此时只能自己实现通信链路，推荐轻量方案：
- 用 URL Hash 变化触发监听：
location.hash = '#data=xxx'，uni-app 侧用@message监听（仅限 H5） - 用
localStorage+storage事件：H5 写入localStorage.setItem('uniData', JSON.stringify(...))，uni-app 监听window.addEventListener('storage', ...) - 避免轮询，也别用
document.cookie—— 同源策略和有效期太难控
Android 上 postMessage 失效的典型表现和修复点
现象是 H5 调了 uni.postMessage，但 uni-app 的 @message 事件完全不触发，logcat 里也无报错。
关键检查项：
- 确认
manifest.json中 Android 模块已勾选 “WebView” 和 “JavaScriptCore”（旧版基座可能默认关） - 检查是否用了腾讯 X5 内核 —— X5 对
postMessage兼容性差，建议在vue.config.js中强制禁用：uni-app: { x5: false } - Android 9+ 默认禁止明文 HTTP 请求，如果 H5 地址是
http://，WebView 可能连页面都加载失败，更别说通信
跨平台通信从来不是“写一次就跑通”，H5、小程序、App 三端的底层机制完全不同，最稳的方式是按端拆逻辑，而不是堆 try-catch。
