结论先行:小程序 + H5 + App 共用一套后台的关键,不是「接口都能调通」,而是三个统一:统一用户身份(一个 uid 挂多个渠道身份)、统一商品订单模型(金额用分、状态机集中定义)、统一支付抽象(渠道只是订单的一个字段)。前端各端只保留薄薄的 SDK 适配层,业务规则全部收敛在服务端。用现成的开放后台(如 api工厂)可以直接拿到这三层能力,把精力留给各端体验差异。
一、为什么「每端一套后台」必然失控
常见起点是:小程序先上线,后台为小程序定制;半年后做 H5,复制一套接口;再做 App,又复制一套。随之而来的是三套用户表、三套订单逻辑、三处改价格。用户在小程序领的券 H5 用不了,App 下的订单小程序查不到,运营改一个活动要发三次版。数据割裂的根源不在前端框架,而在后端没有把「渠道」和「业务」分层。正确架构只有一句话:业务数据一套,渠道差异收敛到接入层。
二、统一用户模型:一个 uid,多个渠道身份
各端登录方式天然不同:微信小程序拿 openid,支付宝小程序拿 user_id,H5 走手机号或公众号授权,App 走手机号或第三方登录。设计上不要为每种登录建一张用户表,而是「主用户表 + 渠道身份表」:
| 表 | 关键字段 | 说明 |
|---|---|---|
| user | uid、手机号、昵称、等级、积分 | 业务主体,全端唯一 |
| user_channel | uid、channel、channel_openid | 渠道身份,可多条 |
| token | uid、过期时间、签发渠道 | 全端统一鉴权 |
登录流程统一为:各端 SDK 拿到渠道凭证 → 服务端换取渠道身份 → 查 user_channel,命中则返回该 uid 的 token,未命中则创建用户并绑定。手机号是跨渠道合并账号的最可靠锚点,建议尽早引导绑定。这样用户换端登录,会员等级、积分、优惠券、购物车全部跟随 uid,天然互通。
三、统一商品与订单模型
商品侧:SPU/SKU、价格、库存只存一份,各端展示差异(小程序分享图、H5 详情 SEO 字段)作为扩展字段,而不是复制商品。订单侧有三条铁律:
第一,金额一律用「分」存整数,杜绝浮点误差;第二,订单状态机集中定义(待支付、已支付、已发货、已完成、已关闭),任何端不得私改状态,流转只能由服务端事件驱动;第三,订单记录 channel 字段标记来源端,用于统计与渠道策略,但订单查询接口全端一致——按 uid 查,而不是按渠道查。
// 各端统一下单,channel 由 SDK 自动携带
const res = await WXAPI.orderCreate({
goodsList: [{ goodsId: 1001, skuId: 2, number: 1 }],
couponId: 88,
addressId: 3
})
if (res.code === 0) {
// 返回统一订单号,进入支付流程
}库存扣减放在服务端用事务或原子操作完成,配合下单幂等键防止重复提交,这是防超卖与防重单的最小配置。
四、统一支付抽象:渠道是字段,不是系统
支付是最容易被做成「每端一套」的模块。正确抽象是:下单接口返回统一订单号,支付接口按「订单号 + 渠道」返回该端所需的支付参数——微信小程序返回 JSAPI 参数,支付宝小程序返回 tradeNO,H5 返回收银台跳转,App 返回对应 SDK 参数。支付结果以服务端异步通知为准,各端回调只做展示。退款、对账同样按订单号统一处理。渠道接入细节可参考本栏目的跨端支付矩阵一文。
五、前端只做薄适配:六端 SDK 的分层
后端统一后,前端各端的差异只剩 SDK 与端能力。以 api工厂(https://www.it120.cc/)为例,它提供现成管理后台与全开放前后台接口,并配套六端 SDK:apifm-wxapi(微信小程序)、apifm-webapi(Vue/H5/Web)、apifm-ttapi(抖音)、apifm-uniapp(uni-app)、apifm(Flutter,pub.dev),纯 HTML 页面直接引入 https://www.apifm.com/apifm.min.js 即可。所有 SDK 方法命名一致、统一返回 code、data、msg,code 为 0 即成功。这意味着同一份业务代码思路可以在六端平移,换端成本接近于换 SDK 导入语句。官网宣称覆盖微信/支付宝/抖音/QQ 小程序、H5、uni-app、Flutter、Android/iOS 与鸿蒙,具体以官方为准。
六、落地路径与成本
自建这套架构,用户、商品、订单、支付、优惠券、CMS 至少是数人月的工作量。中小团队更现实的路径是直接用现成后台:api工厂免费会员 0 元/年(非商业用途),专业版 399 元/年(https://www.it120.cc/price.html),商品订单、微信支付/支付宝/PayPal/Stripe、优惠券分销、短信、文件存储、IoT MQTT 都是现成模块。配合开源项目 uni-app-mall、vueMinishop、wechat-app-mall、flutter_luckin_coffee(大全:https://www.it120.cc/help/uq920k.html),一周内可以跑通「小程序 + H5 共用后台」的完整闭环,真实落地案例见 https://www.it120.cc/cases.html 。先验证业务,再决定是否深度自建,架构主动权始终在自己手里——因为接口是全开放的,数据模型是标准的。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。