如何在 .NET Core 中读取电子邮件收件箱 | IMAP/POP3 指南

Source: Dev.to

为什么要以编程方式读取电子邮件收件箱？

许多应用需要自动获取电子邮件：

• 支持工单系统解析收到的消息。
• 工作流自动化工具监控邮箱以触发事件。
• 合规系统归档电子邮件。
• 集成平台在系统之间同步邮件数据。

在 .NET Core 中读取电子邮件收件箱需要实现 IMAP 或 POP3 协议——这些正是桌面和移动邮件客户端使用的协议。与发送邮件（使用 SMTP 简单直接）不同，读取邮件涉及：

• 安全地连接邮件服务器。
• 进行身份验证（用户名/密码、OAuth 2.0）。
• 解析复杂的 MIME 结构（multipart、嵌入内容）。
• 处理附件和大邮件。
• 管理连接池、超时和重试。

选择协议：IMAP vs. POP3

选择符合需求的协议，然后确认邮件服务器支持的功能（例如 Gmail、Office 365、自托管 Exchange）。

设置 .NET Core 项目

1. 添加邮件库 – 如 MailKit（包含 ImapClient、Pop3Client）。

   dotnet add package MailKit

2. 为 IEmailService 配置依赖注入。

3. 安全存储凭据 – 使用 User Secrets、Azure Key Vault 或环境变量。

4. 在整个服务中启用 async/await，保持操作非阻塞。

连接邮件服务器

• 建立 TLS/SSL 连接 (ImapClient.ConnectAsync(host, port, SecureSocketOptions.SslOnConnect))。
• 安全认证 (client.AuthenticateAsync(username, password) 或 OAuth 2.0 令牌)。
• 实现连接池和超时处理。
• 为掉线提供重连逻辑（指数退避、断路器模式）。

文件夹和消息处理（IMAP）

1. 枚举文件夹 – client.GetFoldersAsync(client.PersonalNamespaces[0])。
2. 如有需要 创建或订阅文件夹（例如 Archive）。
3. 遍历嵌套结构 并遵循特殊用途标记（\Sent、\Trash）。
4. 读取消息标记（Seen、Answered、自定义标记）。
5. 存储 UID 以实现可靠标识和增量同步。

解析消息和附件

1. 获取头部和元数据 – message.Headers、message.Subject、message.Date。
2. 解析 MIME 结构 – 处理 multipart/alternative、multipart/mixed，以及 text/plain 与 text/html。
3. 提取正文部分：
   • 纯文本 (text/plain)
   • HTML (text/html)
4. 处理字符编码 – 必要时转换为 UTF‑8。
5. 识别并提取附件：
   • 保存到磁盘或云存储。
   • 验证类型和大小。
   • 处理嵌入式图片（Content‑Id 引用）。
   • 可选进行病毒扫描。

消息处理与存储

• 将邮件持久化到数据库（例如 Entity Framework Core）。
• 映射字段：发件人、收件人、主题、日期、正文（纯文本 & HTML）、附件元数据。
• 使用消息 UID 或内容哈希 去重。
• 建立索引 以实现高效搜索；如有需要添加全文检索。
• 跟踪同步状态（UID 有效性、上次处理的 UID），支持增量同步。
• 为解析逻辑编写 单元测试，并针对测试邮箱账户编写 集成测试。

错误处理与可靠性

• 网络错误 – 实现指数退避重试。
• 身份验证失败 – 记录日志并报警；支持凭据轮换。
• 格式错误的消息 – 捕获解析异常，跳过或隔离有问题的邮件。
• 超时 – 配置合理的限制并提供回退机制。
• 断路器 – 防止对故障服务器的频繁请求。
• 日志记录 – 包含上下文信息（邮箱、文件夹、UID），便于调试。

Flexy 的现成解决方案

如果您的团队缺乏带宽或对邮件协议的深入了解，Flexy 可以为 .NET Core 提供生产就绪的收件箱集成层：

• 完整的 IMAP/POP3 集成，支持 async。
• 消息解析和附件提取服务。
• 安全凭据管理（最佳实践存储）。
• 强大的错误处理、重试逻辑和监控。
• 用于邮件持久化的数据库模式和 EF Core 模型。
• 完备的文档以及针对不同提供商的配置指南。
• 覆盖常见边缘情况的单元和集成测试套件。

价格与时间表

• 固定价格，无小时计费。
• 典型交付：6–8 天（相较于内部实现的 5–6 周）。

入门指南

如果您的 .NET Core 应用需要可靠的收件箱读取，但希望专注于核心产品功能，请申请免费报价：

1. 描述您的邮件读取需求（邮件提供商、文件夹布局、附件处理）。
2. 提供邮箱场景和处理需求的细节。
3. 获取透明的定价和项目时间表。

获取您的电子邮件收件箱集成免费报价