小程序登录合规:隐私同意、手机号与注销入口

2026-11-19 后端开发 有希 63 次瀏覽

小程序登录合规的难点不在隐私政策文本,而在三个执行顺序:先同意再采集、按主体能力降级、把注销做成独立流程。任何一步顺序错了,用户看到的就是“点了没反应”“授权了还失败”“想删号却找不到入口”。

本文按微信小程序当前的隐私接口、手机号快速验证规则和账号删除流程,拆解一条可以落地的登录链路。文中代码是通用示例,不绑定具体业务字段;平台规则以微信官方文档的当前版本为准。

先分清三种凭据,别把它们混在一起

登录链路上有三个长得很像、作用完全不同的“码”。把它们混用,是后续大多数授权失败和日志泄露的源头。

凭据来源服务端动作常见错误
登录 codewx.login调 code2session 换 openid、session_key当成用户 ID 存库;重复消费
手机号 codegetPhoneNumber 回调调手机号换取接口,得到平台验证过的号码与登录 code 混用;失败后拿旧 code 重试
业务 token自家服务端签发鉴权、续期、撤销注销或改密后没有失效

前两个 code 都是一次性、短时效的。手机号 code 的有效期是 5 分钟,且只能消费一次;它和 wx.login 返回的 code 作用不同,不能互相替代。微信从基础库 2.21.2 起对手机号换取方式做了安全升级,新方式不再要求提前调用 wx.login,这意味着“先登录再绑手机”不再是唯一顺序。

如果登录还涉及网页扫码,票据和轮询是另一套机制,可以对照扫码登录的票据与轮询一起看;本文只讨论小程序内的授权与数据边界。

隐私同意必须在采集之前

很多团队把隐私政策放在“关于我们”里,登录时直接调接口,等真机报错才回头补弹窗。微信的拦截点很明确:只有在小程序管理后台《用户隐私保护指引》里声明过的信息类型,才能调用对应的隐私接口或组件;没声明就直接禁用。

这里有一个常见的误判。早期接入文档要求在小程序配置里打开 __usePrivacyCheck__,于是一看到配置被注释掉,就以为找到了原因。实际上微信已经明确:2023 年 10 月 17 日之后,不论是否配置这个字段,隐私相关功能都会启用;低于基础库 2.32.3 的客户端不集成隐私功能,也不会拦截。也就是说,这个开关今天既不是开关,也不是修复手段,真正要检查的是后台声明和页面里的同意同步。

隐私同意应该做成一个明确的状态,而不是登录按钮里的一个 if。下面是一个最小可用的页面结构:

面板外层由 needPrivacy 控制显隐,面板内部只需要三个可操作元素。同意按钮必须使用 agreePrivacyAuthorization 类型,微信只认这个按钮的同步结果:

<view class="privacy-card">
  <view>登录前请阅读并同意《小程序隐私保护指引》</view>
  <button class="link" bindtap="openPrivacyContract">查看指引</button>
  <button
    id="agree-btn"
    open-type="agreePrivacyAuthorization"
    bindagreeprivacyauthorization="onAgreePrivacy"
  >同意并继续</button>
  <button class="ghost" bindtap="onDisagree">暂不使用</button>
</view>
Page({
  data: { needPrivacy: false, pendingApi: '' },

  onLoad() {
    wx.getPrivacySetting({
      success: (res) => {
        this.setData({ needPrivacy: res.needAuthorization })
      }
    })

    wx.onNeedPrivacyAuthorization((resolve, eventInfo) => {
      this.resolvePrivacy = resolve
      this.setData({ needPrivacy: true, pendingApi: eventInfo.referrer })
    })
  },

  openPrivacyContract() {
    wx.openPrivacyContract({})
  },

  onAgreePrivacy() {
    this.resolvePrivacy?.({ buttonId: 'agree-btn', event: 'agree' })
    this.resolvePrivacy = null
    this.setData({ needPrivacy: false })
    this.startLogin()
  },

  onDisagree() {
    this.resolvePrivacy?.({ event: 'disagree' })
    this.resolvePrivacy = null
    this.setData({ needPrivacy: false })
  }
})

这段代码有三个关键点:

  1. wx.getPrivacySetting 负责首屏判断,用户已经同意过就不再打扰。
  2. wx.onNeedPrivacyAuthorization 负责兜底,用户从其他入口触发隐私接口时也能弹出同一个面板。
  3. 同意按钮必须使用 agreePrivacyAuthorization 类型,微信只有在 bindagreeprivacyauthorization 回调后,才认为用户完成了同步。

如果产品允许“先逛逛”,拒绝按钮应该关闭面板并进入游客态,而不是立刻再次弹窗。反复弹窗既不能拿到授权,也会让审核和用户投诉同时找上门。

从基础库 2.32.3 起,隐私同意按钮还可以和手机号组件耦合,把按钮的 open-type 写成两个值的组合,用竖线分隔。这适合“一次点击完成同意并授权手机号”的场景,但不要把两个回调写成互相等待,否则用户同意后仍可能卡在旧状态。

还要注意:平台拦截的是客户端隐私接口,不是你的服务端。服务端用 code 换 openid、创建账号,同样属于个人信息处理;不能因为平台没拦,就跳过告知和最小化。

手机号快速验证不是所有主体都能用

手机号快速验证组件的能力边界,比很多登录页假设的要窄。微信当前的规定是:只对非个人主体、且完成认证的小程序开放,境外主体仅限部分国家和地区。也就是说,个人主体小程序即使把按钮画出来,用户在真机上也无法完成快速验证。

主体或场景快速验证可用性建议的主路径
个人主体不可用短信验证码绑定,或后续人工补充
非个人且已认证可用,按成功次数计费快速验证为主,短信为兜底
海外主体仅部分国家地区以官方文档的开放范围为准
额度耗尽回调返回错误码切换短信验证,不阻断登录

计费规则也要提前算进产品设计。自 2023 年 8 月 28 日起,手机号快速验证每次成功调用收费 0.03 元;每个小程序账号有 1000 次体验额度,正式版、体验版、开发版共用,超出后开发版同样计费。额度不足时,回调里会出现 e.detail.errno === 1400001,用户侧则可能看到平台默认的“次数已达上限”提示。

因此,手机号按钮不应该成为登录的唯一出口。前端至少要准备两条路径:主体支持时渲染快捷验证按钮,不支持或额度耗尽时切到短信验证。快捷按钮的关键属性如下:

<button
  open-type="getPhoneNumber|agreePrivacyAuthorization"
  bindgetphonenumber="onPhoneNumber"
  bindagreeprivacyauthorization="onAgreePrivacy"
>微信手机号快捷验证</button>
async onPhoneNumber(e) {
  const { code, errMsg, errno } = e.detail
  if (!code) {
    if (errno === 1400001) {
      return this.toast('今日验证次数已用完,请改用短信验证')
    }
    return this.toast('未完成手机号授权')
  }
  await this.request({
    url: 'https://api.example.com/v1/account/phone/wechat',
    method: 'POST',
    data: { code }
  })
}

服务端只做一件事:消费 code,拿到平台验证过的号码,再写入账号。不要在服务端解析前端传来的手机号,也不要把 code 当成长效凭据。

func (s *AccountService) BindPhoneByWeChat(ctx context.Context, userID int64, phoneCode string) error {
    if phoneCode == "" {
        return ErrInvalidPhoneCode
    }
    info, err := s.wechat.ExchangePhoneCode(ctx, phoneCode)
    if err != nil {
        return fmt.Errorf("exchange phone code: %w", err)
    }
    if info.PhoneNumber == "" {
        return ErrPhoneUnavailable
    }
    return s.accounts.BindPhone(ctx, userID, info.PhoneNumber)
}

换取失败时不要复用旧 code 重试。code 已经消费过,重试只会得到“无效 code”,正确的做法是让用户重新点击授权按钮。绑定手机号还要有唯一约束和幂等处理:同一个号码被另一个账号占用时,返回明确的冲突提示,而不是静默覆盖。

openid、手机号、头像昵称的最小化存储

登录合规的另一个落点是“存了什么”。很多账号表在第一次登录时就把能拿到的字段全部落库,后面再想删就很难说清每个字段的用途。

字段是否必要用途建议
openid必要小程序内身份识别只存当前应用所需的标识
unionid条件多应用账号打通没有多应用场景就不要提前采集
手机号条件登录、通知、找回明确用途,支持换绑和解绑
头像昵称非必要展示允许用户自填,不参与身份判断
登录 code不落库一次性交换用完即弃,不写日志
同意记录必要证明同意范围与时间记录版本、来源、时间

头像昵称尤其容易踩坑。wx.getUserProfile 的规则已经调整,接口只能在点击行为中调用,每次请求都会弹出授权窗口,返回的头像昵称也不再适合当作稳定身份。把它当展示字段即可,用户不授权就使用默认头像和可编辑昵称。

openid 的最小化原则是“按应用存、按用途取”。如果业务确实需要跨应用识别,再引入 unionid;两者与账号合并的关系,已经在openid、unionid 与账号合并里展开。另一个常见依赖是内容安全:文本和图片检测都绕不开 openid,但检测结果与登录身份应该分开存放,避免把内容审核日志变成第二套用户画像,具体可以看微信内容安全。

登录日志与错误信息要脱敏

登录链路最容易泄露的不是数据库,而是日志。code 经常被拼进 URL、写进异常信息、带进 APM 的请求快照;手机号和 openid 则经常在“方便排查”的理由下被完整打印。

最低限度要做两件事:敏感参数统一替换,手机号只保留首尾。下面是一段可以直接放进日志中间件的 Go 代码:

var sensitiveQuery = regexp.MustCompile(`(?i)(code|openid|unionid|phone|token)=([^&\s]+)`)

func Redact(raw string) string {
    return sensitiveQuery.ReplaceAllString(raw, "$1=***")
}

func MaskPhone(phone string) string {
    if len(phone) < 7 {
        return "***"
    }
    return phone[:3] + "****" + phone[len(phone)-4:]
}

除了日志,错误响应也要克制。不要把微信返回的原始错误、openid、手机号直接透传给前端;对外只给“授权失败,请重试”这类可操作的信息,把细节留在服务端。

验证手机号换取接口时,可以用 cURL 直接复现一次成功和一次重放。把同一个 code 发两次,第二次必须失败;如果不失败,说明服务端没有正确消费一次性凭据。需要把命令转成代码时,可以用 cURL 转代码 生成对应语言的请求。

curl -sS -X POST 'https://api.example.com/v1/account/phone/wechat' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"code":"<phone-code>"}'

退出登录不等于注销账号

账号设置页里只有一个“退出登录”,是很多小程序上线后的常态。它和注销账号在服务端的语义完全不同:

动作作用范围服务端变化用户预期
退出登录当前设备清除 token 或会话可以马上重新登录
解绑手机号单一绑定关系手机号置空或迁移账号仍然存在
注销账号整个账号冻结、删除或匿名化、撤销全部会话不可恢复或有冷静期

把三者混成一个按钮,会带来两个直接问题:用户以为删了号,其实只是退了登录;或者用户只想换绑手机,却把账号删了。账号设置页至少要拆出“退出登录”和“注销账号”两个入口,解绑手机号则放在安全设置里单独处理。

注销入口的设计不需要复杂,但必须可发现、可完成。常见做法是在账号设置页底部放一个弱化样式的“注销账号”,进入后先说明影响,再走身份校验和二次确认。

注销与数据删除的工程流程

注销不是一条 DELETE 语句。它要同时处理会话、社交身份、业务数据、法定留存和审计记录。一个可执行的流程通常分为六步:

阶段动作失败处理
申请说明影响,要求二次确认未登录先引导登录
校验短信、密码或微信身份校验失败时不泄露账号是否存在
冷静期7 到 15 天内可撤销期间限制新交易和新绑定
冻结撤销全部 token,解绑社交身份异步任务失败可重试
删除或匿名化删除非必要数据,保留法定留存记录删除范围和操作人
完成通知用户,保留最小审计凭证审计只存 ID 与时间,不存明文

几个容易忽略的细节:

  1. 撤销会话要彻底。 只删数据库里的 token 不够,缓存、刷新令牌、第三方登录态都要失效;否则用户注销后仍可能被旧会话访问。
  2. 删除后不要“复活”账号。 如果只按 openid 查账号,用户注销后再次登录会被自动建回原账号。可以保留一个不可逆的 openid 哈希作为删除标记,只用于判断“这个身份已经注销”,不承载任何业务数据。
  3. 区分删除与匿名化。 订单、财务、审计等数据可能受留存要求约束,不能直接物理删除;把用户标识替换为不可关联的随机值,同样能达到“账号不可识别”的效果。
  4. 记录同意版本。 隐私指引更新后,新增的信息类型需要重新同步。同意记录至少包含版本、时间、来源和用户 ID,出问题时才能说明当时同意的范围。

如果账号还绑定了扫码登录、内容发布或交易能力,注销流程要逐个检查关联关系。扫码登录的票据应该立即失效,内容审核记录按留存要求处理,交易数据则进入匿名化而不是直接删除。

上线检查表

把下面这张表当成登录功能的上线前检查,比上线后再补要省事得多。

检查项通过标准
隐私指引声明后台已声明实际采集的信息类型,真机不报 errno 112
首屏隐私判断已同意用户不重复弹窗,未同意用户先看到说明
同意按钮使用 agreePrivacyAuthorization,回调后再调隐私接口
拒绝路径可进入游客态或退出,不循环弹窗
手机号能力按主体决定是否展示,额度不足时自动切短信
一次性凭据code 不落库、不进日志,重放必定失败
日志脱敏code、openid、手机号、token 均不可明文检索
注销入口设置页可发现,流程可完成,会话全部失效
删除标记注销后再次登录不会复活旧账号

FAQ

__usePrivacyCheck__ 还要不要配置?

不需要把它当成开关。2023 年 10 月 17 日之后,隐私功能默认启用;真正决定能不能调接口的是后台《用户隐私保护指引》有没有声明对应类型,以及页面有没有完成同意同步。

wx.login 之前要不要弹隐私授权?

平台拦截的是隐私接口,wx.login 本身不返回用户资料。但只要登录后会采集手机号、头像昵称等信息,就应该在采集前完成告知和同意;服务端创建账号同样属于个人信息处理,不能只看客户端有没有被拦。

个人主体小程序怎么做手机号绑定?

不要展示快速验证按钮,直接走短信验证码或人工绑定。个人主体无法使用手机号快速验证,这是主体能力限制,不是代码问题;把降级路径做成默认路径,比真机报错后再补救更稳。

用户拒绝隐私授权后还能继续浏览吗?

可以,如果产品有游客态,就关闭面板并进入游客态;如果没有,就明确提示“需要同意后才能登录”,不要反复弹窗。拒绝后的路径要可预期,用户才知道下一步该做什么。

登录合规不是一次性的弹窗改造,而是把“同意、采集、存储、删除”四个动作按顺序排好。先把凭据分清,再把主体能力做成降级,最后补上可完成的注销流程,这条链路才算闭环。更多后端实现细节可以继续看后端分类。

評論

登入後即可參與評論

還沒有評論,來說兩句吧

相關文章