小程序登录合规:隐私同意、手机号与注销入口
小程序登录合规的难点不在隐私政策文本,而在三个执行顺序:先同意再采集、按主体能力降级、把注销做成独立流程。任何一步顺序错了,用户看到的就是“点了没反应”“授权了还失败”“想删号却找不到入口”。
本文按微信小程序当前的隐私接口、手机号快速验证规则和账号删除流程,拆解一条可以落地的登录链路。文中代码是通用示例,不绑定具体业务字段;平台规则以微信官方文档的当前版本为准。
先分清三种凭据,别把它们混在一起
登录链路上有三个长得很像、作用完全不同的“码”。把它们混用,是后续大多数授权失败和日志泄露的源头。
| 凭据 | 来源 | 服务端动作 | 常见错误 |
|---|---|---|---|
| 登录 code | wx.login | 调 code2session 换 openid、session_key | 当成用户 ID 存库;重复消费 |
| 手机号 code | getPhoneNumber 回调 | 调手机号换取接口,得到平台验证过的号码 | 与登录 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 })
}
})
这段代码有三个关键点:
wx.getPrivacySetting负责首屏判断,用户已经同意过就不再打扰。wx.onNeedPrivacyAuthorization负责兜底,用户从其他入口触发隐私接口时也能弹出同一个面板。- 同意按钮必须使用
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 与时间,不存明文 |
几个容易忽略的细节:
- 撤销会话要彻底。 只删数据库里的 token 不够,缓存、刷新令牌、第三方登录态都要失效;否则用户注销后仍可能被旧会话访问。
- 删除后不要“复活”账号。 如果只按 openid 查账号,用户注销后再次登录会被自动建回原账号。可以保留一个不可逆的 openid 哈希作为删除标记,只用于判断“这个身份已经注销”,不承载任何业务数据。
- 区分删除与匿名化。 订单、财务、审计等数据可能受留存要求约束,不能直接物理删除;把用户标识替换为不可关联的随机值,同样能达到“账号不可识别”的效果。
- 记录同意版本。 隐私指引更新后,新增的信息类型需要重新同步。同意记录至少包含版本、时间、来源和用户 ID,出问题时才能说明当时同意的范围。
如果账号还绑定了扫码登录、内容发布或交易能力,注销流程要逐个检查关联关系。扫码登录的票据应该立即失效,内容审核记录按留存要求处理,交易数据则进入匿名化而不是直接删除。
上线检查表
把下面这张表当成登录功能的上线前检查,比上线后再补要省事得多。
| 检查项 | 通过标准 |
|---|---|
| 隐私指引声明 | 后台已声明实际采集的信息类型,真机不报 errno 112 |
| 首屏隐私判断 | 已同意用户不重复弹窗,未同意用户先看到说明 |
| 同意按钮 | 使用 agreePrivacyAuthorization,回调后再调隐私接口 |
| 拒绝路径 | 可进入游客态或退出,不循环弹窗 |
| 手机号能力 | 按主体决定是否展示,额度不足时自动切短信 |
| 一次性凭据 | code 不落库、不进日志,重放必定失败 |
| 日志脱敏 | code、openid、手机号、token 均不可明文检索 |
| 注销入口 | 设置页可发现,流程可完成,会话全部失效 |
| 删除标记 | 注销后再次登录不会复活旧账号 |
FAQ
__usePrivacyCheck__ 还要不要配置?
不需要把它当成开关。2023 年 10 月 17 日之后,隐私功能默认启用;真正决定能不能调接口的是后台《用户隐私保护指引》有没有声明对应类型,以及页面有没有完成同意同步。
wx.login 之前要不要弹隐私授权?
平台拦截的是隐私接口,wx.login 本身不返回用户资料。但只要登录后会采集手机号、头像昵称等信息,就应该在采集前完成告知和同意;服务端创建账号同样属于个人信息处理,不能只看客户端有没有被拦。
个人主体小程序怎么做手机号绑定?
不要展示快速验证按钮,直接走短信验证码或人工绑定。个人主体无法使用手机号快速验证,这是主体能力限制,不是代码问题;把降级路径做成默认路径,比真机报错后再补救更稳。
用户拒绝隐私授权后还能继续浏览吗?
可以,如果产品有游客态,就关闭面板并进入游客态;如果没有,就明确提示“需要同意后才能登录”,不要反复弹窗。拒绝后的路径要可预期,用户才知道下一步该做什么。
登录合规不是一次性的弹窗改造,而是把“同意、采集、存储、删除”四个动作按顺序排好。先把凭据分清,再把主体能力做成降级,最后补上可完成的注销流程,这条链路才算闭环。更多后端实现细节可以继续看后端分类。
評論
還沒有評論,來說兩句吧