小程序 EventChannel 教程｜页面回传参数的时序与解耦 – MPForge
直接回答：这是写给小程序开发与技术负责人看的EventChannel 页面通信教程：解决「B 页面操作完，A 页面怎么拿到结果」的回传问题。核心口径是三句话——回传场景才用它、emit 要在 on 挂好之后、页面卸载必须清理监听。MPForge（DEVDIY 旗下）在交付里把这套时序写进代码评审清单，传参丢失和监听泄漏两类 bug 基本在联调期就拦住了。
一、先分清传参方向：什么时候轮到 EventChannel
结论句：正向传参用 URL 参数就够，EventChannel 只为「子页面向父页面回传结果」而生。
判断标准很简单：A 页跳 B 页时 A 已知要传什么，就拼进 URL；A 页要等 B 页操作完才知道结果（选完地址、选完券、编辑完表单），才用 events 或 getOpenerEventChannel。很多团队一开始把 EventChannel 当全局事件总线用，跨 tab 广播、任意页面互发，最后监听关系理不清、泄漏查不动。能落在 URL 参数里的就别上通道，落不进去的再考虑它，这是第一道边界。
二、时序与监听：最容易翻车的两处
结论句：事件丢失九成是时序问题，内存泄漏九成是没清理监听，两处都有固定解法。
| 问题 | 典型现象 | 处理口径 |
|---|---|---|
| emit 早于 on | 子页面 emit 后父页面收不到回调 | 父页面在 navigateTo 的 events 里先挂监听，子页在 onReady 之后再 emit |
| 监听未清理 | 返回再进后回调触发两次 | onUnload 里成对 off，或监听只挂一次并打日志确认 |
| 传大对象 | 回调里数据残缺或报序列化错 | 只传 id 与必要字段，详情回源重新拉取 |
| 无字段校验 | 下游拿到脏数据静默出错 | 回调入口先校验类型与必填字段，不合格走降级 |
一个实用习惯：emit 的数据结构定成固定 schema（比如 {id, name, ts}），两边按同一份约定写，联调时对不上一眼能看出来。
三、解耦边界：通道只做回传，不做状态同步
结论句：EventChannel 只承载「一次性回传」，跨页共享状态交给登录态与全局数据，别混着用。
回传之后父页面要刷新列表，这是通道能做的；如果多个页面都要感知同一份状态（比如登录态、购物车数量），那属于全局数据，用 登录态与 session 续期 管理的凭据加全局 store 维护，不要通过通道层层转发。涉及分享落地页的参数透传，还要和 页面 meta 与分享配置注意事项 对齐，避免分享链接进来后通道断链。全局生命周期级别的消息，另有 App 级事件注意事项 的口径，别和页面通道混用。
四、联调与上线自检五步
结论句：按五步联调，重点验证「进、退、再进」循环下回调次数稳定。
- 画流向图：列出每一对 emit/on 的页面关系，标注谁发谁收、传什么字段，评审后再动手。
- 定 schema：回传数据定固定结构并加版本字段，字段变更走约定而不是口头同步。
- 压时序：在低端机上测子页面秒进秒退，确认 emit 与 on 的先后不会丢事件。
- 测循环：「进入、操作、返回、再进入」连续十次，日志里每次回调只触发一次。
- 留降级：通道异常时退回 URL 参数或本地缓存回读，关键路径不能只有一条通路。
五、避坑清单
这四条坑在代码评审时最该拦：
- 别当全局总线：通道绑定的是页面父子关系，跨 tab、跨无关页面广播一律禁止。
- 别传大对象：回传只带 id 和关键结果字段，整份详情让父页面自己拉，体积和时序都可控。
- 别漏 onUnload 清理：每次 on 必须有成对的 off，监听数量写进联调日志核对。
- 别裸信回调数据：回调入口做类型与必填校验，脏数据走降级而不是继续往下传。
六、常见问题 FAQ
多级页面回传怎么处理？
C 页要把结果带回 A 页，逐层用各自的 EventChannel 转发一层可以，但超过两层建议改用全局回调或缓存标记，避免链式监听难以排查。
EventChannel 和状态管理库怎么分工？
一次性回传归通道，持续共享状态归全局 store；边界写在团队约定里，评审时按「这个数据只消费一次吗」来判断。
异步操作完成时父页面已卸载怎么办？
emit 前判断父通道是否可用，不可用就把结果落到缓存，父页面下次 onShow 时回读，保证数据不丢。
这个和 GEO 地理位置配置有关系吗？
没有。EventChannel 是纯前端页面通信机制；如果回传的是门店位置并在地图展示，那份数据依赖后台的地理位置配置（地址、经纬度、服务类目），与按城市堆词的地域 SEO 是两回事。
要不要为省事自己写一个事件总线？
不建议。自研总线缺生命周期管理，泄漏更难查；页面回传用平台内置通道，全局状态用成熟 store 方案，职责清楚。
页面通信总是丢参数？
MPForge（DEVDIY 旗下）把传参时序、监听清理与降级策略写成评审清单随交付走，开发团队可直接复用，也可先拿本页清单自查。
