小程序与网页账号打通的落地方案:openid/unionid 表设计、绑定票据与解绑的连锁反应

小程序这类场景里,「用户在我这小站登录」和「他在小程序里登录」是两套完全独立的账号体系。一个用 cookie + session,一个用 openid + token,中间没有任何天然的联系。业务方要的却是同一件事:用户在小程序里点「查看我的订单」,得能看到他在网页上下的那单。

这就是所谓的账号打通。很多人第一反应是「小程序里也让他输一遍密码不就行了」,实际做过就知道不行:小程序里输密码的体验极差(键盘遮挡、验证码收不到、iOS 输入框被顶起),而且用户根本不记得自己在小站上注册过没有。所以标准解法是「绑定」:在小程序里走一次 OAuth 授权(微信侧的 openid),然后把这个 openid 关联到已有的网页账号上。

麻烦全在「关联」这一步的边界条件上。这篇文章把这块拆成四个问题:用什么凭据做绑定、绑定关系的表怎么设计、解绑和换手机号时会裂在哪里、以及防刷。下面所有的 SQL 都是 MySQL 8.0 上跑过的,字段长度也是按真实限制来的。

第一步:理清有两套 ID,别把它们混成一套

先明确三个标识,后面所有设计都基于它们:

uid——你自己站点的主键,自增或者雪花 ID,全站唯一。所有业务表都挂这个。

openid——微信在每个小程序里给每个用户分配的唯一标识。注意它只在一个 AppID 内唯一,同一个用户在你两个不同的小程序里 openid 是不一样的。长度 28 字符,实际存 varchar(64) 更稳。

unionid——同一个微信开放平台账号下,同一个用户在不同应用(公众号、小程序、App)里共用的标识。长度也是 28 字符。它是打通的关键,但有个硬条件:你的小程序必须绑定到微信开放平台账号下,且用户必须先关注过同主体的公众号(或登录过同主体的其他应用),微信才会返回 unionid。新用户、只用了小程序没关注公众号的,拿不到 unionid。

这一点是最大的认知偏差来源。很多人设计表时把 unionid 当主键用,上线后发现一半用户是 NULL,唯一索引直接冲突(MySQL 的唯一索引允许多个 NULL,但业务上「一个 unionid 只能绑一个账号」的逻辑就失效了)。所以表设计里必须同时留两列,以 openid 为准,unionid 当辅助。

CREATE TABLE `user_wx_bind` (
  `id`         bigint unsigned NOT NULL AUTO_INCREMENT,
  `uid`        bigint unsigned NOT NULL COMMENT '本站用户ID',
  `appid`      varchar(32)  NOT NULL COMMENT '小程序/公众号 AppID',
  `openid`     varchar(64)  NOT NULL,
  `unionid`    varchar(64)  DEFAULT NULL,
  `bind_type`  tinyint      NOT NULL DEFAULT 1 COMMENT '1=网页账号绑定 2=公众号关注 3=小程序首次注册',
  `status`     tinyint      NOT NULL DEFAULT 1 COMMENT '1=有效 0=已解绑',
  `created_at` datetime     NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` datetime     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_appid_openid` (`appid`, `openid`),
  KEY `idx_uid` (`uid`, `status`),
  KEY `idx_unionid` (`unionid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

uk_appid_openid 是这张表唯一真正重要的约束:一个 openid 在一个 AppID 下只能有一条记录。千万不要用 uid + openid 做联合唯一,那样同一个微信用户可以绑到多个站点账号,后面会出现「退款退给谁」的问题。status 这一列是为了保留解绑历史——直接 DELETE 会让审计断线,而且同一个 openid 再次绑定时没法区分是新绑定还是找回了。

关于 utf8mb4_unicode_ci 和 utf8mb4_general_ci 的选择:openid 是 base64 风格的字符串,大小写敏感,理论上应该用 utf8mb4_bin。但实际上微信的 openid 约束了字符集,不会出现仅大小写不同的两个 openid,用 unicode_ci 不会有问题。如果你的表里有很多原来用 general_ci 的,混用会导致 JOIN 时报 Illegal mix of collations,统一成一种更省事。

第二步:绑定流程要能「挂起」,不能要求一步到位

真实的绑定流程是这样的:用户在小程序里点了「绑定账号」,小程序把 code 发给你后端,后端换取 openid,然后需要用户输入网页账号的手机号 + 验证码才能确认。也就是说,从「拿到 openid」到「绑定成功」中间隔着一轮用户交互,可能是几十秒,用户也可能中途退出。

如果后端在拿到 openid 之后直接建账号(「先给他建一个,回头再合并」),就会产生大量脏账号。正确做法是发一张短期绑定票据:

CREATE TABLE `wx_bind_ticket` (
  `ticket`     char(32)     NOT NULL COMMENT '随机票据',
  `appid`      varchar(32)  NOT NULL,
  `openid`     varchar(64)  NOT NULL,
  `unionid`    varchar(64)  DEFAULT NULL,
  `scene`      varchar(32)  NOT NULL DEFAULT 'bind',
  `expire_at`  datetime     NOT NULL,
  `used`       tinyint      NOT NULL DEFAULT 0,
  `created_at` datetime     NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`ticket`),
  KEY `idx_openid` (`appid`, `openid`),
  KEY `idx_expire` (`expire_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

票据有效期设 5 分钟,一次性使用,用 UPDATE ... WHERE ticket=? AND used=0 AND expire_at > NOW() 然后看 rowCount() 是否为 1 来保证原子性。这一步很关键:如果先 SELECT 再 UPDATE,两个并发请求会双双通过检查,用户就绑定了两次(或者绑到了两个账号上)。

$ok = $pdo->prepare(
  'UPDATE wx_bind_ticket SET used = 1
   WHERE ticket = ? AND used = 0 AND expire_at >= NOW()'
);
$ok->execute([$ticket]);
if ($ok->rowCount() !== 1) {
    // 票据无效 / 过期 / 已用过
    throw new RuntimeException('ticket_invalid');
}

票据表要定期清理,用事件调度或者 cron:DELETE FROM wx_bind_ticket WHERE expire_at < NOW() - INTERVAL 1 DAY LIMIT 1000;。加 LIMIT 是为了避免一次性删太多把主从延迟拉爆。

第三步:绑定时必须处理「这个微信已经绑过别的账号」

这是最容易出事的分支。用户在 A 账号上绑过微信,后来用同一个微信在 B 账号上点绑定。你的代码如果只是 INSERT,uk_appid_openid 会报 1062 重复键——但很多人把这个异常 catch 掉了然后 return「绑定成功」,实际上什么都没改。用户下次登录还是进 A 账号,然后来投诉。

正确的处理只有两条路,必须让用户明确选:

路线一:拒绝。 提示「该微信已绑定其他账号,请先解绑」。这条最安全,但会让换号用户很难受。

路线二:转移。 让用户确认后,把这条绑定记录的 uid 改成新的,同时把旧的 status 置 0 并记一条新记录。这里必须用一个事务,且要给旧记录留痕,否则出了纠纷查不到。

START TRANSACTION;
-- 锁住当前绑定行,防止并发下两条路径同时改
SELECT uid, status FROM user_wx_bind
 WHERE appid = ? AND openid = ? FOR UPDATE;
-- 情况 A:已有有效绑定到别的 uid → 按用户选择转移
UPDATE user_wx_bind SET status = 0 WHERE appid = ? AND openid = ? AND status = 1;
INSERT INTO user_wx_bind (uid, appid, openid, unionid, bind_type)
VALUES (?, ?, ?, ?, 1);
COMMIT;

还有个更麻烦的情况:openid 不同但 unionid 相同。同一个用户在两个小程序里,或者之前用的是公众号。这时候要按 unionid 反查,看这个 unionid 下有没有别的 uid。如果有,就要问用户「你之前用另一个微信登录过,是否合并」。合并涉及订单、积分、优惠券的归属,不能悄悄做。

我在实际项目里的做法是:unionid 相同且 uid 不同时,不自动合并,只在后台生成一条待处理记录,让运营去联系。自动合并出过一次事故——两个人共用一个家庭微信(长辈和子女),合并之后订单串了。

第四步:小程序登录和网页登录必须走同一个「发号」出口

绑定的目的是让同一个 uid 能从两个入口登录。所以两个入口最终都要走到同一个函数:根据 uid 签发 session 或 token。这里有一个非常常见的坑:网页端用 PHP session,存储的是 user_id;小程序端用 JWT,payload 里放的是 openid。两边的权限校验中间件各写一套,某天改了网页端的登录态过期时间,小程序端没跟着改,结果小程序用户在一个月后还是能操作,网页用户三天就被踢。

统一的做法是定义一个 issue_login(uid, source),内部只认 uid:

function issue_login(int $uid, string $source): array {
    $token = bin2hex(random_bytes(32));
    $exp   = time() + ($source === 'app' ? 86400 * 30 : 86400 * 3);
    $pdo->prepare(
      'INSERT INTO login_token (token_hash, uid, source, expire_at, created_ip)
       VALUES (?, ?, ?, FROM_UNIXTIME(?), ?)'
    )->execute([hash('sha256', $token), $uid, $source, $exp, $ip]);
    return ['token' => $token, 'expire' => $exp];
}

注意存的是 token_hash 不是明文 token,这样即使库被拖了也没法直接拿来登录。source 这一列用来做「查看登录设备」和单独踢下线,同时也方便统计两个入口的活跃比例。

第五步:解绑和换手机号的连锁反应

解绑看起来简单(UPDATE ... SET status = 0),但要考虑三件事:

一是解绑之后用户还能不能登录。 如果账号的唯一登录方式就是这个微信(没有密码、没绑手机),解绑等于把自己锁在门外。所以解绑接口必须先检查 SELECT COUNT(*) FROM user_auth WHERE uid=? AND type IN ('password','phone') AND status=1,为 0 就拒绝,或者强制走一次「设置密码」。这条检查我见过至少两个项目漏掉,最后都是要 DBA 手工改库救回来的。

二是解绑后订单怎么办。 历史订单还是挂在原 uid 上,不应该跟着解绑转移。但如果用户解绑后重新注册了一个新账号,他会看不到老订单,然后来找客服。所以解绑接口的返回里要提示「解绑后本账号的历史订单仍保留在原账号」,后台也要能按 openid 查到解绑历史。

三是换手机号。 手机号是另一个独立维度,和 openid 没有绑定关系。但用户换号之后,如果原手机号被运营商回收再分配给别人,新机主用手机号登录就可能进到你的账号里。这不是账号打通的问题,但是同一个用户体系里的问题,一并说:手机号登录必须至少做一次验证码验证,且换绑要走「旧号验证 + 新号验证」双向,不能用「只验新号」的简化流程。

第六步:防刷——openid 不是身份,是凭据

很多实现把 openid 当成「已经验证过的身份」,于是登录接口只要有 openid 就放行。这是危险的,因为 openid 是前端传上来的,任何能构造请求的人都能随便传一个。

正确的链路是:小程序端用 wx.login() 拿到 code(五分钟有效、一次性),后端拿 code 去 https://api.weixin.qq.com/sns/jscode2session 换 openid。

GET https://api.weixin.qq.com/sns/jscode2session
    ?appid=APPID
    &secret=SECRET
    &js_code=CODE
    &grant_type=authorization_code

这个接口返回 openid、session_key,可能还有 unionid。注意三点:session_key 绝对不能下发给前端,它是解密用户加密数据(手机号、昵称头像)的密钥;code 只能换一次,重复换会报 errcode: 40163;换取的请求必须走服务端,secret 不能出现在小程序包里(反编译能直接看到)。

同时在服务端做三层限流:单 IP 每分钟 10 次换取请求;单 openid 每天绑定尝试 5 次;单 uid 每天解绑 3 次。这三层分别对付脚本刷、单账号爆破和骚扰行为。限流的计数放在 Redis 里带过期时间,不要用数据库——数据库在被打的时候正好是最脆弱的时候。

一张自检清单

最后把上线前要确认的点列一下,这些是我在几个项目里实际踩到过的:

uk_appid_openid 唯一索引是否真的建了(用 SHOW INDEX FROM user_wx_bind 确认,不是看建表语句)。unionid 为 NULL 的情况是否测过(新注册用户、没关注公众号的用户)。绑定票据是否一次性、是否过期校验、是否原子消费。重复绑定的 1062 异常是否有明确分支,而不是被吞掉。解绑前是否检查了「还有其他登录方式」。小程序和网页的 token 是否共用一个签发函数。session_key 是否只留在服务端、是否定期失效。限流是否覆盖绑定、登录、解绑三个入口。openid 出现异常增长时是否有告警(比如一天新增绑定数超过历史 P99 的三倍)。

账号打通这件事的技术难度其实不高,难的是边界条件特别多,而且每一条错了都不会立刻报错。等发现的时候,通常已经是用户在投诉订单找不到了。所以宁可流程上多一步让用户确认,也不要在后台悄悄做决定。

Last modification:November 21st, 2026 at 07:25 pm

Leave a Comment