Office单点登录(SSO)加载项切换账户未生效问题咨询

AI 小北

2026-8-13

解决Office SSO加载项切换账户无需重启的方案

可以不用关闭并重新打开加载项，通过监听Office账户切换事件并重置身份验证状态即可实现，具体操作如下：

监听账户切换事件：Office提供ActiveAccountChanged事件用于捕获客户端账户切换动作，在加载项初始化阶段注册该事件的监听器。
清理旧身份凭证：切换账户后，清除之前缓存的token、用户信息；若使用Yeoman生成项目默认依赖的MSAL.js，需清空MSAL实例的缓存或直接重置实例。
重新触发SSO流程：调用获取新账户身份凭证的方法，更新加载项内的用户信息及业务逻辑依赖的身份数据。

代码示例

在任务窗格核心逻辑文件（如taskpane.js）中添加如下处理：

Office.onReady(async () => {
  // 注册账户切换事件监听器
  Office.context.mailbox.addHandlerAsync(Office.EventType.ActiveAccountChanged, handleAccountSwitch);
  // 初始化加载当前账户信息
  await loadCurrentUserInfo();
});

async function handleAccountSwitch() {
  // 获取项目中的MSAL实例（根据项目实际实例获取方式调整）
  const msalInstance = getMsalInstance();
  // 清空MSAL缓存，移除旧账户凭证
  await msalInstance.clearCache();
  
  // 重新加载新账户的用户信息
  await loadCurrentUserInfo();
}

// 项目中原有的加载用户信息方法（示例）
async function loadCurrentUserInfo() {
  const token = await getAccessToken(); // 项目内获取SSO token的方法
  const userInfo = await fetchUserProfile(token); // 调用接口获取用户信息
  // 更新界面显示的用户名、邮箱等内容
  document.getElementById('username').textContent = userInfo.name;
  document.getElementById('email').textContent = userInfo.email;
}