Mac版Outlook插件用MSAL/GraphAPI时ssoSilent刷新令牌失败

已知问题确认 #

这是Mac版Outlook的已知兼容性问题，微软Office插件生态在Mac端的dialog API与MSAL-JS的交互存在特殊限制，已有不少开发者反馈过类似场景的报错。

原因分析 #

• Mac版Outlook的WebView容器（无论新旧版本内核）对第三方Cookie、跨域会话的处理逻辑，和Windows端/普通浏览器环境差异明显，ssoSilent依赖的静默令牌刷新所需会话上下文无法在dialog的WebView中正确传递。
• Mac版Outlook对dialog窗口的生命周期管控更严格，ssoSilent尝试静默操作时，WebView没有足够权限访问已有的登录会话，直接判定需要用户交互。
• MSAL-JS的ssoSilent在Mac Outlook的dialog环境中，无法通过iframe完成静默授权（容器限制了iframe跨域行为），仅能尝试刷新令牌但会话缺失，最终触发报错。

解决建议 #

• 环境适配处理：检测当前运行环境是否为Mac版Outlook，在该环境下跳过ssoSilent调用，直接使用简化的交互式登录流程（如调用loginPopup），避免不必要的错误触发。
• 优先使用Office SSO：插件初始化时先尝试通过Office.context.auth.getAccessToken获取身份令牌，优先借助Office内置的SSO能力，而非纯依赖MSAL的ssoSilent；若Office SSO不可用，再回退到MSAL流程。
• 优化dialog体验：调用displayDialogAsync打开授权窗口时，设置最小尺寸（如height: 100, width: 300），模拟Windows端的短暂弹窗效果，即使触发交互式登录，也尽量降低对用户的干扰。
• 错误重试策略：捕获USER_INTERACTION_REQUIRED错误后，先尝试1次acquireTokenSilent重试，或检查令牌缓存中的刷新令牌，尝试用刷新令牌获取新的访问令牌，再考虑触发完整交互式登录。
• 检查应用注册配置：确保Azure AD应用注册中已正确配置Mac版Outlook对应的重定向URI，且权限范围设置准确，避免因配置问题导致会话验证失败。

内容的提问来源于stack exchange，提问作者DEC