目录模型最诱人的一句话是「写一次,跑在每个超级 App 里」。到 2025 年,这不再是个说辞,成了不少开发者的 survival 策略——单一宿主上的平台抽成和政策反复,让人不想再被人质化。有团队把一份小程序发进了 11 个宿主,微信、Telegram、几个合作伙伴 App,代码一次都没分支。不是因为宿主一样,而是因为从第一个 commit 起,团队就拒绝让三样东西漏进构建。

支付,是「一样」最先崩的地方

每个宿主都有自己的钱。微信支付、Telegram Stars、合作伙伴自有的 PSP,每一个返回不同的回调形态、按不同的时间线结算、以不同的方式失败。团队常犯的错,是写个 handleWeChatCallback(),然后因为 if (host === 'telegram') 把它复制十一遍。那不是多宿主,那是十一个 App 穿了件戏服。正确的抽象是:支付只暴露一个 pay(order) 接口,宿主差异全部推到适配层,新增一个宿主只加一个 adapter,而不是改十一处。

登录身份,断在跨宿主

微信给你 openid,Telegram 给你 tg user id,自有账号体系给你另一套。一个用户在微信发现小程序、后来从 Telegram 进来,在后端表里就是两个人,真实的跨宿主 LTV 算不出来。把身份也抽象成一个 resolveIdentity() 接口、由适配层把各宿主 id 映射回内部统一 id,才能避免重复用户和错乱归因。

差异源写死的后果抽象后的代价
支付回调每宿主复制一份每宿主一个 adapter
登录身份跨宿主用户裂解统一 id 映射
审核节奏一改动全重审分层发布

审核节奏,是看不见的工期

各宿主的审核周期完全不同:有的小时级,有的按周。一个牵涉到支付逻辑的改动,可能被某个慢宿主卡住三周,而其他十个已经上线——于是运行时的版本错配开始出现,某个宿主还在跑旧版运行时,新功能在那里静默失效。能控的做法是把宿主差异完全压到适配层,核心逻辑零分支,这样任一宿主的审核延迟都不会传染到别人。某团队把支付抽象成 adapter 之后,新增一个宿主的集成周期从三个月压到两周。

配置驱动,而不是代码分支

把宿主差异压进适配层之后,还要守住一条:核心逻辑零分支。新增一个宿主,应该是加一个 adapter 加一段配置,而不是在十一个地方写 if (host === ...)。一旦有人在核心路径里为某个宿主开了特例,多宿主就从「一份代码」退回「十一个 App 穿戏服」。某团队立下规矩:任何 host 字面量出现在核心模块里都算 review 红线,差异只允许活在 adapters/ 目录,新增宿主的集成周期因此从三个月压到两周。

一份构建,多个产物

把宿主差异压进配置之后,构建也要跟上:理想形态是一次构建产出按宿主参数注入的多个产物,而不是一个包里塞满运行时分支。宿主的 app id、支付渠道、回调域名都在构建期注入,运行时只读配置、不做判断。某团队切到这套之后,核心包不再因为「为某个宿主留的特例」而膨胀,新宿主接入从改代码变成填一份配置加一个 adapter,两天的活。构建期注入和运行时零分支,是多宿主能长期不腐坏的两块基石。

一句话收尾

多宿主真正的考题,不是「能不能跑」,而是「改一处会不会让十一个宿主一起返工」。把宿主差异全部关进适配层、核心逻辑保持宿主无关,写一次才真的能跑到处。

参考来源