朋友发来一张卡片:「就差你一票,点一下补上」。你点了。小程序开在首页,那一票没了,还得从头把那个群找出来。没崩,按钮也好好的,是链接把该带的东西丢了。

这种毛病我们上线过不止一次,问题多半不在按钮。是把链接当成了地址,而它本该是一句话:打开这个、停在这个状态、给这个人、从这个地方来。被网页 URL 训练了这么多年,我们习惯把链接当位置。可在超级 App 里,一条不带上下文的链接几乎算不上链接——它只是一把开前门的钥匙。

链接是一句话,不是地址

每个入口在第一屏渲染之前,都会先递给你一小包上下文。有你能控制的部分——商品 id、群 id、活动标记、谁分享的;也有宿主自己的元数据,比如场景值,告诉你这次是从二维码贴纸、聊天会话,还是从桌面快捷方式进来的。微信管它叫场景值,支付宝有自己那套叫法,Telegram 机器人在首次 /start 时拿到一个 start 参数。名字不同,意思一样:宿主已经知道你是怎么来的,去读它,别猜。

实操上就一条:让分享带上状态。用户从商品页分享出去,卡片就该带着那个商品 id,把收的人直接落在那一屏,而不是甩到首页配一句「快看看」。活动导流进来,第一屏就该是活动许诺的那个东西。听着像废话,直到你真去查一个线上应用,发现一半卡片都指着根路径。

还有条教训是踩坑换来的:身份、价格、权限别放进参数。链接里的东西都是客户端给的。把 payload 当成「该往哪儿走」的提示,至于这个人到底能看什么,交给服务端定。

两条路,同一份参数

多数团队栽在这儿。入口不是一个,是两个,而且行为不一样。

冷启动——小程序本来没在跑——payload 交给启动生命周期,你读一次、定路由、渲染目标屏,没问题。但如果小程序已经开着、压在后台,一条新链接不会把它重启,而是唤醒。新 payload 走的是 onShow 那类回调,当前页不会重新加载;你要是没显式处理这个回调,人就停在十分钟前离开的那一屏上。这就是那种「点了没反应」的毛病,它不崩,所以测试很容易放过。

所以两头都得管:启动时解析并路由一次,每次回到前台再解析并路由一次。同一个小函数,两个调用点。漏了第二个,差不多一半深链会悄没声地什么都不做。

入口形态携带什么落到哪一屏常见丢失点
聊天里转发的分享卡片商品 id、群 id、谁分享的那件商品或那个群,状态一并带上卡片指向首页路径,上下文压根没离开发送方
带场景值的二维码场景 id、活动、投放位活动专属的第一屏链接被复制到宿主外时,场景参数被剥掉
广告或短信链接活动、素材、一小段 payload广告真正许诺的那个优惠外部浏览器打不开宿主 scheme,点一下就到死胡同
推送或订阅消息一个理由、一个目标屏具体某一屏,不是消息列表模板限额把自定义字段丢了,点开是个通用页
已经打开的小程序唤醒时的一份新参数唤醒时重新决定的新目标没处理 onShow,旧页面就那么杵着

归因是在哪儿悄悄没的

接下来说实在的。先假定它一定会丢一部分。 payload 会被截断:长度上限、特殊字符、某个你没料到的编码环节、宿主转发时把链接重写了一遍。宿主对外部唤起也设了卡子。浏览器或短信里的链接往往得用特定 scheme,可能被拦、可能先弹一层确认才肯开;而给一家宿主生成的链接,在另一家根本打不开。我们当然想要一条通吃的 URL,但没有哪家宿主愿意,所以别照着这个设计。一家宿主做一个入口,其余留个朴素的网页兜底。

归因在任意一端都可能断。发的人改了 path。收的人把链接复制到别的群,场景 id 没跟过去。第二次打开把正准备记的冷启动参数覆盖了。有人把二维码截图发出去而不是扫。不管多小心,最后总会剩一桶「来源未知」,装作没有,只会养出一堆笃定但错误的看板。

还有安全这笔账。你要是图路由省事,信了查询串里的 user id 或者管理员标记,那就是白送一个越权漏洞。每次都在服务端校验。链接只负责告诉你落到哪儿,绝不该告诉你这个人是谁。

设计下一张分享卡片之前,先试一件事:打开小程序,把它压到后台,再从另一个会话点一条新链接。要是它落在旧屏上,你就找到了大多数团队都会带上线那个 bug。把唤醒那条路补上,payload 保持又短又无聊,敏感的东西一律服务端校验——至于有人把场景 id 粘进群里之后丢掉的那部分,是得学会共存的缺口,不是能补上的洞。

参考来源