微信小程序 web-view 的 message 事件收不到，根本原因是它不触发标准 window.postMessage，只认 @message 事件，且需满足域名已配置、H5 为 HTTPS、web-view 加载完成三个条件。
微信小程序 web-view 的 message 事件为什么收不到
根本原因是 web-view 在小程序环境里不触发标准的 window.postMessage，也不支持 uni.onMessage —— 它只认自己平台定义的 @message 事件，且必须满足三个硬性条件：域名已配置为业务域名、H5 页面 HTTPS、web-view 组件挂载完成并加载完毕。
常见错误现象包括：@message 回调完全不执行、event.detail 是空对象、调试工具里看不到任何消息日志。
- 必须在微信公众平台「开发管理 → 开发设置」中添加 H5 域名，且校验文件需部署在该域名根路径（如
https://your.com/MP_verify_xxx.txt） -
web-view的src必须是完整 HTTPS URL，不能是http://或本地file:// - 不要在
onLoad钩子中立刻发消息，应监听@load事件，在回调里再调用uni.postMessage（注意：这是小程序端向 H5 发消息的 API，不是浏览器原生的） - H5 页面内不能直接调用
uni.postMessage，它在小程序 web-view 环境中未注入；正确做法是用window.parent.postMessage(data, '*')，且必须等DOMContentLoaded后再发
uni.postMessage 在小程序里调用报错 “is not a function”
这个错误说明你正在用 App 端的写法写小程序逻辑：uni.postMessage 在小程序环境中根本不存在，它是 App 端（plus 环境）专用 API。小程序 web-view 的通信完全依赖平台原生机制，和 uni-app 的跨端统一 API 无关。
实操上，小程序端向 H5 传数据只有两种合法方式：
-
URL 参数传递：最稳妥，适合初始化数据（如
token、theme、scene），但有长度限制（建议 ≤ 2KB），且需encodeURIComponent编码 -
通过
web-view的bindmessage+postMessage模拟：H5 页面需主动监听message事件，而小程序侧无法主动调用 JS，只能靠 URL 或用户交互触发 H5 再拉取数据
例如 H5 中这样收：
window.addEventListener('message', (e) => {
if (e.source === window.parent && e.data?.from === 'miniprogram') {
console.log('收到小程序指令:', e.data)
}
})
如何让 H5 主动通知小程序跳转或触发原生能力
小程序 web-view 是单向容器，不提供 evalJS 或运行时注入能力，所以 H5 无法直接调起 wx.navigateTo 或访问 wx.chooseImage。必须借助微信 JS-SDK 搭桥，且前提是 H5 页面已完成 JS-SDK 签名配置。
关键步骤：
- H5 页面必须引入
https://res.wx.qq.com/open/js/jweixin-1.6.0.js（注意版本兼容性） - 后端需提供签名接口，返回
appId、timestamp、nonceStr、signature，用于wx.config初始化 - 调用前必须确保
wx.ready触发，否则所有 API 报错config:fail - 跳转到小程序页面用
wx.miniProgram.navigateTo，不是uni.navigateTo；复制用wx.setClipboardData；打开相册用wx.chooseImage
典型错误是签名 URL 与当前页面 URL 不一致（比如带了 query 参数但签名时没包含），导致 config:invalid signature。
Android/iOS/App/小程序混用时最容易忽略的一点
同一套 H5 代码跑在不同容器里，window.uni、window.wx、plus 这些全局对象的存在性和行为完全不同。不加判断直接调用，轻则静默失败，重则 JS 报错中断流程。
务必在 H5 入口做环境探测：
if (window.wx && window.wx.miniProgram) {
// 小程序 web-view
} else if (window.plus) {
// App 端
} else if (window.uni && window.uni.postMessage) {
// uni-app 打包的 H5 被其他 uni-app 加载（如 nvue）
} else {
// 纯浏览器环境
}
所有通信入口都得包裹在这个判断里，否则 iOS 下 postMessage 失效、小程序里 uni 报 undefined、App 里 wx 报错——这些坑都是因为忘了“先看环境，再动手”。
