---
title: Exchange 中链接邮箱导致 OWA 登录报 TokenMungingException 的处理
description: 迁移或跨版本升级 Exchange 后，部分本应是普通用户邮箱的账户被标记为链接邮箱，访问 OWA 时返回 TokenMungingException。本文说明成因判断、准备与风险、清理 LinkedMasterAccount 的步骤、验证与回退方法，并给出常见问题排查思路。
url: "https://www.lanever.com/docs/exchange-%e4%b8%ad%e9%93%be%e6%8e%a5%e9%82%ae%e7%ae%b1%e5%af%bc%e8%87%b4-owa-%e7%99%bb%e5%bd%95%e6%8a%a5-tokenmungingexception-%e7%9a%84%e5%a4%84%e7%90%86/"
updated: "2026-10-12"
category: Exchange
---

# Exchange 中链接邮箱导致 OWA 登录报 TokenMungingException 的处理

## 适用场景

Exchange 环境在跨版本升级、跨林迁移或邮箱搬迁后，部分账户访问 OWA 时登录失败，页面返回类似 `X-OWA-Error: Microsoft.Exchange.Security.Authentication.TokenMungingException` 的错误标识。排查后发现这些账户在目录中被识别为**链接邮箱（Linked Mailbox）**，但其实际用途是普通用户邮箱，且 `LinkedMasterAccount` 属性被错误填充。本文针对该情形给出通用处理流程。

该问题与具体版本号无关，不同 Exchange 版本的行为可能存在差异，涉及具体版本支持范围时请查阅对应版本的官方文档。

## 原理说明

链接邮箱用于资源林与账户林分离的部署模型，邮箱对象通过 `LinkedMasterAccount` 指向账户林中的主账户。当该属性被意外写入，而环境中并不存在对应的账户林关系时，OWA 在构造身份令牌阶段无法完成账户解析，从而抛出令牌处理异常。将 `LinkedMasterAccount` 置空后，账户恢复为普通用户邮箱，OWA 登录即可正常进行。

## 准备与风险

- 操作对象为目录中的用户对象属性，属于配置变更，务必先在测试环境验证。
- 执行前记录受影响账户的当前属性值，便于回退。
- 确认账户确实不应为链接邮箱；若环境本身使用资源林模型，禁止执行本操作。
- 使用具备相应管理权限的账户，通过 Exchange 命令行管理程序（EMS）以管理员身份运行。
- 批量操作前先导出账户清单，避免误改范围。

## 处理步骤

1. 确认当前属性。执行：
   ```
   Get-User -Identity "[用户标识]" | Format-List LinkedMasterAccount
   ```

   若输出非空，说明该属性已被填充。
2. 记录原值，保存到变更单或本地文件，作为回退依据。
3. 清除属性。执行：
   ```
   Set-User -Identity "[用户标识]" -LinkedMasterAccount $null
   ```

   该命令通常无输出，属正常现象。
4. 批量处理时，可先准备仅含用户标识列的 CSV 文件，再通过管道逐条传入，避免手工逐个执行。执行前务必确认 CSV 内容准确。
5. 等待目录复制完成。多域或多站点环境中，属性同步需要一定时间，期间结果可能不一致。

## 验证方法

- 再次执行 `Get-User -Identity "[用户标识]" | Format-List LinkedMasterAccount`，确认输出为空。
- 在邮箱属性中确认邮箱类型已不再显示为链接邮箱。
- 使用受影响账户登录 OWA，确认不再出现令牌处理异常。
- 抽查若干账户，确认未对其他属性造成非预期改动。

## 回退建议

若清除后出现异常，可依据此前记录的原值，将 `LinkedMasterAccount` 重新设置为原账户标识。回退同样需要等待目录复制生效。若无法确认原值，应从备份或目录还原途径恢复，不要凭猜测填写。

## 常见问题

- 清除后仍报错：先确认目录复制是否完成，再检查账户是否还有其他异常属性。
- 只有部分账户受影响：通常与迁移过程中属性继承或写入逻辑有关，按账户逐一核对。
- 能否直接删除并重建邮箱：不建议，可能造成数据丢失，优先采用属性修正方式。
- 命令无输出是否代表失败：该命令成功执行时通常无输出，以验证步骤的结果为准。
- 生产环境批量执行前，务必在测试环境完整演练并确认回退路径可用。

> 提示：本文所述命令为通用形式，实际参数名称、可用属性及行为请以所用 Exchange 版本的官方文档为准。
