Exchange 2016 CU12中getCallbackTokenAsync调用失败技术求助

首先，针对你遇到的ErrorInvalidClientAccessTokenRequest错误，结合Exchange 2016 CU12本地部署的特性，我来帮你梳理问题原因和解决步骤，同时解答你的几个疑问：

一、错误原因定位 #

你提供的错误详情：

{"Header":{"ServerVersionInfo":{"MajorVersion":15, "MinorVersion":1, "MajorBuildNumber":1713, "MinorBuildNumber":5, "Version":"V2017_07_11" }}, "Body":{"ResponseMessages":{ "Items":[{"__type":"GetClientAccessTokenResponseMessage:#Exchange", "MessageText":"The token for this extension could not be retrieved.", "ResponseCode":"ErrorInvalidClientAccessTokenRequest", "ResponseClass":"Error", "Token":null}] }}}

这个错误本质是本地Exchange没有正确配置支持Web Add-ins获取REST令牌的环境——Office 365是默认完成所有OAuth和REST相关配置的，但本地Exchange需要手动设置关键组件。

二、你的疑问逐一解答 #

1. REST API是否仅支持Office Online？ #

当然不是。Exchange 2016（包括CU12及后续累积更新）本地部署完全支持REST API，不需要依赖Office Online环境。两者的区别在于O365自动配置好了所有必要的身份验证和端点，而本地部署需要你手动完成这些配置。

2. Exchange本地部署是否必须通过HYBRID对接Exchange Online才能使用？ #

完全不需要。Hybrid架构是为了实现本地与云端Exchange的协同，和Web Add-ins调用本地REST API没有强制关联。你可以在纯本地Exchange环境下实现这个功能。

3. 无Office Online环境，本地部署Exchange下该如何实现功能？ #

你需要完成以下几个核心配置步骤：

步骤1：启用组织级OAuth2支持

打开Exchange Management Shell，执行以下命令启用OAuth2客户端配置，这是Add-ins获取令牌的基础：

Set-OrganizationConfig -OAuth2ClientProfileEnabled $true

步骤2：注册你的Web Add-in到本地Exchange

如果你的Add-in是内部开发的，需要将其清单文件注册到Exchange组织中。执行以下命令（替换为你的Add-in信息）：

New-App -OrganizationApp -Url "https://your-addin-host/manifest.xml" -Name "Your Archive Add-in"

注意：清单文件中的Permissions需要设置为符合你需求的权限（比如ReadWriteMailbox），同时Domains节点要包含Add-in部署的域名，避免跨域问题。

步骤3：验证REST端点配置

检查Exchange的Web Services虚拟目录配置，确保内部/外部URL可被Add-in访问：

Get-WebServicesVirtualDirectory | Select-Object Server, InternalUrl, ExternalUrl

如果是纯内部使用，至少要保证InternalUrl是Add-in客户端能访问的地址；如果需要外部访问，要正确配置ExternalUrl并做好DNS解析。

步骤4：确认Add-in的安装和上下文

确保你的Add-in已经被正确安装到用户的Outlook客户端（桌面或OWA）中，并且当前用户对目标邮箱有足够的权限（比如读取权限）。

三、额外排查建议 #

• 检查浏览器网络请求：在浏览器开发者工具中查看getCallbackTokenAsync发起的实际请求，确认是否能到达Exchange的OAuth端点，有没有401/403等权限错误。
• 查看Exchange事件日志：在Exchange服务器的应用程序日志中搜索OAuth或GetClientAccessToken相关的错误条目，里面可能有更详细的失败原因。
• 先测试OWA环境：如果Outlook桌面客户端有问题，先在OWA中测试Add-in，排除桌面客户端的配置干扰。

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