生命周期与账号切换
销毁运行资源与忘记旧会话是两件不同的事。
正确顺序
- 同一个主机、key、entryId、userScope 只创建一个客户端;同一账号下反复打开复用该实例。
- 前台展示时 setChatVisible(true),折叠时 false;小程序 onShow / onHide 接到客户端,后台暂停轮询。
- 退出登录前 forgetSession(),在 finally 中 destroy();注销订阅和宿主事件。
- 为新账号使用新的随机隔离编号。不要仅改昵称、重用旧 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.
}使用流程预览 · 示意图
帮助理解此示例的使用顺序,不执行代码或验证连接。
- 准备
client 为当前账号创建的实例,unsubscribe 是对应订阅返回值。
- 在项目中使用
web/account-switch.mjs · 模块文件
- 核对结果
退出账号前调用此函数;即使清理出错也销毁旧实例。下一账号使用新 userScope。
预期结果:退出账号前调用此函数;即使清理出错也销毁旧实例。下一账号使用新 userScope。
清理边界
destroy() 只释放资源,不能代替清除本机凭据;forgetSession() 不撤销企业账户,也不取消已经到达服务端的工作。原生容器按各端生命周期教程关闭整个旧页面。
实现依据 · 仓库内路径
sdk/wechat-miniapp/index.jssdk/client-kit/web/client.mjs
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。