开发者文档中心

OpenAPI进入控制台

隐私与权限 · 2026-10-31

生命周期与账号切换

销毁运行资源与忘记旧会话是两件不同的事。

正确顺序

  1. 同一个主机、key、entryId、userScope 只创建一个客户端;同一账号下反复打开复用该实例。
  2. 前台展示时 setChatVisible(true),折叠时 false;小程序 onShow / onHide 接到客户端,后台暂停轮询。
  3. 退出登录前 forgetSession(),在 finally 中 destroy();注销订阅和宿主事件。
  4. 为新账号使用新的随机隔离编号。不要仅改昵称、重用旧 UUID 或恢复旧页面实例。

Web 账号切换清理

运行前

web/account-switch.mjs · 模块文件 · 接入包 0.3.15

  • client 为当前账号创建的实例,unsubscribe 是对应订阅返回值。
完整代码 · 10 行
web/account-switch.mjsJavaScript
// Call before replacing the host's signed-in account. Neither argument authenticates the user.
export function disposeSupportForAccountChange(client, unsubscribe) {
  try {
    client.forgetSession();
  } finally {
    try { unsubscribe?.(); }
    finally { client.destroy(); }
  }
  // Create the next instance with a fresh host-owned userScope; never replay old pending writes.
}
使用流程预览 · 示意图

帮助理解此示例的使用顺序,不执行代码或验证连接。

  1. 准备

    client 为当前账号创建的实例,unsubscribe 是对应订阅返回值。

  2. 在项目中使用

    web/account-switch.mjs · 模块文件

  3. 核对结果

    退出账号前调用此函数;即使清理出错也销毁旧实例。下一账号使用新 userScope。

预期结果:退出账号前调用此函数;即使清理出错也销毁旧实例。下一账号使用新 userScope。

清理边界

destroy() 只释放资源,不能代替清除本机凭据;forgetSession() 不撤销企业账户,也不取消已经到达服务端的工作。原生容器按各端生命周期教程关闭整个旧页面。

实现依据 · 仓库内路径
  • sdk/wechat-miniapp/index.js
  • sdk/client-kit/web/client.mjs

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。