连接邮箱会在五个可区分的位置失败，产品会指明是哪一个。在这里找到你的消息，而不是重 新跑一遍向导 —— 重复同一个错误的重试，要付两次授权页面的代价。
阶段 1 —— 登录根本没开始
*“无法启动 Google 登录流程”或“无法启动 Microsoft 登录流程”*意味着失败在我们这边 或浏览器那边，还没轮到服务商。要么是弹窗被拦了，要么是我们这边的 OAuth 客户端配置有 误。立刻重试一次是合理的；重试五次不是。
阶段 2 —— 授权页面
登录未成功，附有：
原因：
access_denied。常见原因：您取消了授权页面，或 OAuth 客户端配置有误。请重试 或联系支持团队。
常见得多的 Gmail 失败根本没有报错。Google 把两项权限摆成两个单独的复选框，默认全 不勾，向导会在把你交出去之前先警告：
如果您漏勾任何一个复选框，收发都无法工作，您将不得不重做这个流程。
一个连接完成了却永远收不到 —— 或完成了却发不出 —— 几乎都是这个。没有消息，因为什么 都没失败；你被授予的，正是你同意授予的。
阶段 3 —— 指认邮箱
每种形态有自己的诊断消息，每条都点出解法。
| 消息 | 它的意思 |
|---|---|
| ”您的帐户对此共享邮箱没有 Full Access 权限。“ | Exchange 的授权缺失，或者授给了别的账号，不是你登录用的这个 |
”support@contoso.com 在您的 Microsoft 365 租户中不存在。“ | 打错了字，或者邮箱在另一个租户里，不是你登录的这个 |
| ”共享邮箱只存在于 Microsoft 365（工作／学校）租户中……” | 你用个人 Outlook.com / Hotmail / Live 账号登录了 |
| ”无法列出您的群组” | Groups 调用失败，或者你不属于任何群组 |
| ”该成员邮箱没有把群组地址配置为「Send mail as」别名。“ | Google 群组路径：回复会以成员而不是群组的身份发出 |
| ”未找到已验证的别名 — 请在 Gmail 设置中添加” | 别名在 Gmail 里还没验证 |
阶段 4 —— 验证一直没有回来
往返验证让邮箱给自己发一条消息。它没回来时，原因在基础设施，而不是你点了什么，向导 会说明是哪一边：
这通常表示 Pub/Sub 推送订阅配置不正确 — 请查看
docs/email-channel/runbooks/pubsub-watch-recovery.md中的运维手册，或联系支持团队。
对 Outlook 而言，这通常表示 Graph 订阅无法访问 — 请确认
API_PUBLIC_URL指向一个 公网 HTTPS 源（开发环境用 ngrok），并且 webhook 校验握手有正常响应。请查看docs/email-channel/runbooks/azure-bootstrap.md或联系支持团队。
在 Microsoft 侧下结论之前，先等一等：
Microsoft 会把权限查询缓存约 15 分钟 — 授权后首次发送和首次入站可能会短暂显示为旧 状态。
管理员授完权限几分钟后就失败的首次发送，多半是那个缓存，而在窗口期内重跑设置什么也 诊断不出来。
阶段 5 —— 本来好好的，后来停了
渠道断开了。
**渠道已断开。**以上的历史消息仍可查看，但 AI 无法再回复，您也无法从这里发送。请在 设置 → 渠道中重新连接邮箱以恢复。
通常是 OAuth 授权被撤销、密码被更改，或者管理员收走了这条连接借用的权限。在 Workspace 共享收件箱或 Exchange 共享邮箱上，这一点值 得说出口：连接跑的是你的访问权，你丢了，邮箱也跟着丢。
连接彻底没有了。
此邮箱连接已不可用 — 它可能已被删除，或者当初没有完成设置。从渠道页面重新连接该邮 箱，会开始一次全新、干净的设置。
按字面意思接受 —— 重新开始，别试图修补。
不属于这一页的事
如果邮箱连接得好好的，是某一封邮件没被回复，那是另一个问题，有它自己的答案： AI 为什么没有回复一封邮件。