用途:该技能用于在 CloudBase 项目中为微信小程序实现身份认证,包括小程序登录、在云函数中获取用户身份(openid、unionid),以及构建需要识别用户的小程序功能。其核心优势是小程序调用云函数时,微信会自动注入并验证用户身份,无需复杂 OAuth 流程或手动传递凭据。
主要能力:用户身份标识包括 OPENID(用户在当前小程序的唯一标识)、APPID(小程序 App ID)、UNIONID(同一微信开放平台账号下跨应用的用户标识,仅在绑定开放平台账号且用户授权时可用)。这些值由微信验证,可信,无需额外校验。多数情况下无需显式登录 API,身份在云函数中直接可用。
使用方式:先确认 CloudBase 环境 ID,并确保小程序已关联该环境。在小程序入口 app.js 中调用 wx.cloud.init({ env: 'your-env-id', traceUser: true }) 初始化一次(traceUser 可选)。云函数中使用 wx-server-sdk,以 cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV }) 初始化,再通过 cloud.getWXContext() 获取 { OPENID, APPID, UNIONID }。小程序端可用 wx.cloud.callFunction({ name: 'getUserInfo', data: {} }) 调用云函数并处理 success/fail。测试认证时可写一个返回 success 与 identity 的简单云函数,在小程序页面调用并展示结果。
适用场景:需要在小程序中实现用户识别、基于 OPENID 的授权与访问控制、跨多小程序或公众号识别同一用户(UNIONID 可用时)等。建议将 OPENID 存入数据库用于关联数据,不要向其他用户暴露。
限制:不适用于网页端微信登录、Node SDK 服务端认证,以及非微信的认证方式。UNIONID 可能为 undefined,需做可用性判断后回退。应使用官方文档中出现的 API,并始终进行云函数调用错误处理。