个人小程序账号合并:openid、unionid 与手机号绑定
个人主体通常拿不到 unionid,账号合并只能围绕手机号和邮箱做。下面按一套真实实现拆开 openid 自动建号、邮箱注册、绑定迁移和解绑兜底,重点说明:绑定不等于合并。
结论:个人小程序没有稳定的跨端主键
先把三个标识分开。openid 是微信用户在单个小程序里的编号,按 appid 隔离;unionid 需要一个开放平台账号把多个应用串起来;手机号和邮箱则是业务自己验证出来的身份,不依赖微信应用体系。
| 标识 | 来源 | 作用范围 | 个人主体可用性 | 适合做主键 |
|---|---|---|---|---|
| openid | wx.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 移到 B | A 的订单、积分、收藏不迁移 |
| 给账号换绑邮箱 | 新邮箱写入,旧邮箱被替换 | 旧邮箱对应的历史数据不转移 |
| 解绑微信 | 绑定关系删除 | 账号本身不删除 |
如果 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。
真要合并时,按这个顺序做
如果产品明确要合并两个已有账号,建议把“登录入口迁移”和“数据合并”拆成两个动作,并且只对验证过的联系方式做匹配。
- 选主账号:最近登录、有可用联系方式、有业务数据的一方,或让用户自己选择。
- 验证归属:手机号或邮箱验证码,不能只凭 openid。
- 事务迁移:把社交绑定和业务数据改到主账号,记录迁移前后的编号。
- 处理冲突:同一业务表有唯一约束时,保留有效记录,另一条标记合并来源。
- 失效旧会话:删除或过期源账号 token,避免合并后还能用旧令牌操作。
- 软删源账号:保留审计,不物理删除;同时保留 openid 映射,防止同一微信再次自动建号。
| 阶段 | 要做什么 | 失败时 |
|---|---|---|
| 验证 | 双向验证联系方式 | 终止,不改数据 |
| 迁移 | 事务内改归属 | 回滚 |
| 收尾 | 失效 token、软删、写审计 | 可重试 |
这套流程现有实现没有做,文章里的绑定接口只是入口迁移。不要把“绑定成功”当成“数据已合并”。
FAQ
个人小程序一定拿不到 unionid 吗?
不一定,但个人主体通常无法完成开放平台绑定,所以实际拿不到。即使能拿到,也要在用户重新授权时回填,历史数据不会自动出现。
同一个微信换 appid 后 openid 会变吗?
会。openid 按 appid 隔离,换 appid 后旧绑定匹配不上,系统会把用户当新账号。
绑定微信会把旧账号的数据带过来吗?
不会。当前实现的绑定是删除旧绑定再新建,业务数据仍留在原账号。
用户先用微信登录,又用邮箱注册,怎么办?
这是两个账号。让用户登录目标账号后重新绑定微信,或走人工合并;不要仅凭邮箱相同就自动合并,除非邮箱已经验证且产品明确接受数据迁移规则。
解绑微信后账号还能找回吗?
只有绑定了手机号或邮箱才能找回。纯 openid 账号解绑后没有入口,当前实现不会阻止这种操作。
小结
个人小程序的账号合并,核心不是写一个绑定接口,而是承认 openid 不是跨端主键。把手机号或邮箱验证好,把绑定当迁移而不是合并,把解绑和并发唯一性守住,账号体系才不会在换 appid 或换登录方式时塌掉。更多后端鉴权与数据一致性文章见后端开发。
評論
還沒有評論,來說兩句吧