个人小程序账号合并:openid、unionid 与手机号绑定

2026-11-19 后端开发 有希 38 次浏览

个人主体通常拿不到 unionid,账号合并只能围绕手机号和邮箱做。下面按一套真实实现拆开 openid 自动建号、邮箱注册、绑定迁移和解绑兜底,重点说明:绑定不等于合并。

结论:个人小程序没有稳定的跨端主键

先把三个标识分开。openid 是微信用户在单个小程序里的编号,按 appid 隔离;unionid 需要一个开放平台账号把多个应用串起来;手机号和邮箱则是业务自己验证出来的身份,不依赖微信应用体系。

标识来源作用范围个人主体可用性适合做主键
openidwx.login 的 code 换取单个小程序可用否,换 appid 就失效
unionid绑定开放平台后返回同一主体下的多个应用通常拿不到理论可用,但历史数据不会自动补齐
手机号短信验证码验证业务全局可用,但不能用小程序手机号快速验证组件是
邮箱邮件验证码验证业务全局可用是

个人主体通常无法把小程序绑定到微信开放平台,所以服务端只能稳定拿到 openid。更麻烦的是,openid 按 appid 隔离:换一个小程序,同一个微信用户就是另一个 openid。

所以这类系统的账号合并,实际是“以验证过的手机号或邮箱为主键,把 openid 当作可迁移凭证”。扫码登录本身的票据与轮询实现,可以看个人小程序实现网站扫码登录。

三张表:账号、社交身份、绑定关系

把登录方式和账号分开,后面才谈得上迁移。真实实现里是三张表:账号表保存手机号、邮箱和密码;社交身份表保存 openid;绑定表把两者连起来。

CREATE TABLE app_user (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  mobile VARCHAR(11) NULL,
  email VARCHAR(255) NULL,
  password VARCHAR(100) NOT NULL DEFAULT '',
  status TINYINT NOT NULL DEFAULT 1
);

CREATE TABLE social_account (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  type TINYINT NOT NULL,
  openid VARCHAR(32) NOT NULL,
  nickname VARCHAR(32) NOT NULL DEFAULT '',
  KEY idx_type_openid (type, openid)
);

CREATE TABLE social_binding (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  user_id BIGINT NOT NULL,
  social_account_id BIGINT NOT NULL,
  social_type TINYINT NOT NULL,
  KEY idx_user_type (user_id, social_type),
  KEY idx_social (social_account_id)
);

示例省略了租户、审计和软删字段。这里有两个容易被忽略的细节:

  • 社交身份表用 openid 做身份键,没有 unionid 列。原始授权结果里即使带了 unionId,也没有落到独立字段。
  • 账号表的手机号和邮箱没有唯一索引,当前表结构里甚至没有为它们建普通索引。也就是说,“一个手机号只对应一个账号”目前靠应用层查询保证,不是数据库保证。

第二点会在并发注册时暴露出来。先记住这个前提,后面再展开。

两条建号路径:扫码自动建号与邮箱注册

首次扫码:系统先建一个“空账号”

扫码确认后,服务端用 wx.login 的 code 换 openid。若该 openid 没有绑定记录,默认路径是创建账号并立即绑定,然后签发令牌。

func (s *AuthService) SocialLogin(ctx context.Context, req SocialLoginReq) (*LoginResp, error) {
    social, err := s.social.GetByCode(ctx, req.Type, req.Code)
    if err != nil {
        return nil, err
    }
    if social == nil {
        return nil, errors.New("解析不到三方登录信息")
    }

    var user *User
    if social.UserID != 0 {
        user, err = s.users.Get(ctx, social.UserID)
    } else {
        user, err = s.users.Create(ctx, social.Nickname, social.Avatar, clientIP(ctx))
        if err != nil {
            return nil, err
        }
        if _, err = s.social.Bind(ctx, user.ID, req.Type, req.Code); err != nil {
            return nil, err
        }
    }
    if err != nil {
        return nil, err
    }
    return s.issueToken(ctx, user, social.OpenID)
}

这条路径很顺,但新建账号上只有昵称、头像和随机密码,手机号、邮箱都是空。用户下次在网页用邮箱注册时,系统不认识这是同一个人,于是产生第二个账号。

首次入口是否建号账号上有什么
小程序扫码或快捷登录是openid 绑定,手机号/邮箱为空
手机验证码登录手机号不存在时建号手机号
邮箱验证码注册是邮箱和密码
H5 三方登录是对应平台的 openid 绑定

这不是实现缺陷,而是个人主体缺少 unionid 时的必然结果:没有可信的跨端标识,服务端不能凭昵称、头像或“看起来像同一个人”做自动合并。

邮箱注册:第二套身份入口

为了给网页用户一个不依赖微信的入口,系统增加了邮箱验证码注册。流程是先查重,再消费验证码,最后建号并直接登录。

func (s *AuthService) Register(ctx context.Context, req RegisterReq) (*LoginResp, error) {
    email := strings.TrimSpace(req.Email)
    if email == "" {
        return nil, errors.New("请输入邮箱")
    }

    existing, err := s.users.GetByEmail(ctx, email)
    if err != nil {
        return nil, err
    }
    if existing != nil {
        return nil, errors.New("该邮箱已注册,请直接登录")
    }

    if err := s.mailCodes.Use(ctx, email, req.Code, SceneRegister); err != nil {
        return nil, err
    }
    user, err := s.users.CreateByEmail(ctx, email, req.Password, clientIP(ctx))
    if err != nil {
        return nil, err
    }
    return s.issueToken(ctx, user, email)
}

查重放在消费验证码之前,避免用户收完验证码才发现邮箱已被占用。这个顺序是对的,但它不是原子操作:两个请求可以同时查到“邮箱不存在”。

同类问题也存在于邮件验证码的消费。更新已使用状态时只按记录 id 更新,没有把 used = 0 放进 WHERE:

UPDATE mail_code
SET used = 1, used_time = NOW()
WHERE id = ?;

并发提交同一个验证码时,两条请求都可能先读到 used = 0,再先后执行这条更新。加上账号表没有唯一索引,最终可能插入两条相同邮箱的账号。

要彻底解决,需要数据库唯一索引,或者在事务里锁住邮箱对应的记录。只靠应用层的 FindByEmail 不够。

绑定不是合并:它只把登录入口搬走

用户登录到 B 账号后,在小程序里点“绑定微信”,服务端做的事是:先把该微信身份从旧账号上删除绑定,再删掉 B 账号原有的同类型绑定,最后新建一条绑定。

func (s *SocialService) Bind(ctx context.Context, userID int64, typ int64, code string) (string, error) {
    social, err := s.authByCode(ctx, typ, code)
    if err != nil {
        return "", err
    }
    if social == nil {
        return "", errors.New("社交用户不能为空")
    }

    // 同一个微信身份,先从前一个账号上摘下来
    if err := s.binds.DeleteBySocialAccount(ctx, social.ID); err != nil {
        return "", err
    }
    // 当前账号已有的同类型绑定,也要先删掉
    if err := s.binds.DeleteByUserAndType(ctx, userID, typ); err != nil {
        return "", err
    }

    return social.OpenID, s.binds.Create(ctx, Binding{
        UserID:          userID,
        SocialAccountID: social.ID,
        SocialType:      typ,
    })
}

注意这里没有迁移任何业务数据,三步也没有包在同一个事务里。它的语义是“换绑”,不是“合并”。

操作实际发生没有发生
在 B 账号绑定同一微信微信绑定从 A 移到 BA 的订单、积分、收藏不迁移
给账号换绑邮箱新邮箱写入,旧邮箱被替换旧邮箱对应的历史数据不转移
解绑微信绑定关系删除账号本身不删除

如果 A 账号只有这个微信登录方式,绑定到 B 后,A 就变成没有入口的孤岛账号。更隐蔽的是,换绑过程没有提示旧账号是谁,用户很容易以为自己只是“多绑了一个登录方式”。

实际实现里还有一个失败窗口:两个删除和一次新建不在同一事务中。第二步删除成功、第三步插入失败时,当前账号会短暂没有该类型绑定。生产上应把这三步放进事务,并在换绑前检查该微信是否已经属于另一个账号。

很多产品希望“自动合并”,但自动合并必须回答:哪个账号存活、订单和积分归谁、旧 token 是否立即失效、出问题能否回滚。只凭“同一个微信”不能回答这些问题,尤其在个人主体没有 unionid 的情况下。

解绑的底线:不能把账号解成无人认领

手机号和邮箱的解绑做了兜底:解绑手机号前必须已绑定邮箱,解绑邮箱前必须已绑定手机号,并且都要消费当前联系方式的验证码。

func (s *UserService) UnbindMobile(ctx context.Context, userID int64, code string) error {
    user, err := s.users.Get(ctx, userID)
    if err != nil {
        return err
    }
    if user.Email == "" {
        return errors.New("请先绑定邮箱,解绑手机号后账号将无法通过手机号找回")
    }
    if err := s.codes.UseSMS(ctx, user.Mobile, code, SceneUpdateMobile); err != nil {
        return err
    }
    return s.users.ClearMobile(ctx, userID)
}

这个约束的方向是对的:不能把所有可验证的联系方式一次性解光。但三方绑定没有同样的兜底。当前解绑接口只要求登录态,删除绑定前不检查账号是否还有手机号、邮箱或其他社交绑定。一个纯 openid 账号解绑微信后,就没有任何登录入口了。

建议至少加两层:一是解绑前检查是否还有别的登录方式;二是敏感解绑要求一次重新验证,不能只凭已有会话。登录态校验的边界可以看Gin 公开接口可选鉴权。

解绑对象当前校验风险
手机号必须已绑邮箱 + 当前手机验证码低
邮箱必须已绑手机 + 当前邮箱验证码低
微信小程序仅登录态纯 openid 账号会失去入口

四个边界

换 appid 后 openid 会变

openid 按 appid 隔离。换小程序主体或 appid 后,同一个微信用户会得到新的 openid,旧的绑定记录匹配不上,系统会把他当新用户。个人主体没有 unionid 可以做兜底,所以换 appid 前必须让用户先绑定手机号或邮箱;否则老账号只能靠人工找回。

保留旧 appid 一段时间、让用户逐个登录回填新 openid,也是一种迁移方式,但需要同时维护两套配置。

unionid 不会自动补历史

即使以后把小程序绑到开放平台,历史 openid 记录也不会自动多出一列 unionid。用户需要再次登录,服务端拿到新的授权结果后才能回填。回填前,老数据仍然只能靠手机号或邮箱关联。

同一个微信在不同主体下不是同一个 openid

如果以后做了第二个小程序,且没有开放平台把它们串起来,两个 openid 之间没有任何可直接比较的关系。不要用昵称、头像或“看起来像同一个人”做自动合并。

二维码和回调里不要放身份

扫码登录的二维码只应携带一次性票据,不应把 openid、用户编号或手机号编码进去。票据泄露最多被抢一次登录,身份标识泄露会把账号结构暴露出去。排查二维码内容时,可以用二维码解码确认 payload 只有随机 ticket。

真要合并时,按这个顺序做

如果产品明确要合并两个已有账号,建议把“登录入口迁移”和“数据合并”拆成两个动作,并且只对验证过的联系方式做匹配。

  1. 选主账号:最近登录、有可用联系方式、有业务数据的一方,或让用户自己选择。
  2. 验证归属:手机号或邮箱验证码,不能只凭 openid。
  3. 事务迁移:把社交绑定和业务数据改到主账号,记录迁移前后的编号。
  4. 处理冲突:同一业务表有唯一约束时,保留有效记录,另一条标记合并来源。
  5. 失效旧会话:删除或过期源账号 token,避免合并后还能用旧令牌操作。
  6. 软删源账号:保留审计,不物理删除;同时保留 openid 映射,防止同一微信再次自动建号。
阶段要做什么失败时
验证双向验证联系方式终止,不改数据
迁移事务内改归属回滚
收尾失效 token、软删、写审计可重试

这套流程现有实现没有做,文章里的绑定接口只是入口迁移。不要把“绑定成功”当成“数据已合并”。

FAQ

个人小程序一定拿不到 unionid 吗?

不一定,但个人主体通常无法完成开放平台绑定,所以实际拿不到。即使能拿到,也要在用户重新授权时回填,历史数据不会自动出现。

同一个微信换 appid 后 openid 会变吗?

会。openid 按 appid 隔离,换 appid 后旧绑定匹配不上,系统会把用户当新账号。

绑定微信会把旧账号的数据带过来吗?

不会。当前实现的绑定是删除旧绑定再新建,业务数据仍留在原账号。

用户先用微信登录,又用邮箱注册,怎么办?

这是两个账号。让用户登录目标账号后重新绑定微信,或走人工合并;不要仅凭邮箱相同就自动合并,除非邮箱已经验证且产品明确接受数据迁移规则。

解绑微信后账号还能找回吗?

只有绑定了手机号或邮箱才能找回。纯 openid 账号解绑后没有入口,当前实现不会阻止这种操作。

小结

个人小程序的账号合并,核心不是写一个绑定接口,而是承认 openid 不是跨端主键。把手机号或邮箱验证好,把绑定当迁移而不是合并,把解绑和并发唯一性守住,账号体系才不会在换 appid 或换登录方式时塌掉。更多后端鉴权与数据一致性文章见后端开发。

评论

登录后即可参与评论

还没有评论,来说两句吧

相关文章