.NET Core Docker部署应用邮件发送超时问题排查

针对本地运行正常、Docker部署后邮件发送超时且无异常捕获的问题，可从以下方向逐一排查：

1. 容器网络连通性验证 #

• 进入Docker容器内部，执行telnet <你的SMTP主机> <端口>（默认25），若无法连通，说明容器到SMTP服务器的网络被阻断：
  • 检查主机防火墙是否允许容器访问目标SMTP端口；
  • 若使用云服务器，确认服务商是否禁用了25端口（多数云厂商默认封禁25端口，需改用465/587端口）；
  • 尝试切换Docker网络模式为host，验证是否是桥接网络的规则限制。

2. 补充SmtpClient关键配置 #

代码未指定端口且禁用SSL，可能不符合现代SMTP服务器的要求：

• 显式指定SMTP端口（如587或465），并匹配对应的SSL设置：

  public async Task<bool> SendEmailAsync(MailMessage message, EmailConfigDto config)
  {
      try
      {
          // 补充端口参数，例如587
          using SmtpClient smtpClient = new(config.StmpHost, config.SmtpPort);
          // 587端口通常需要启用SSL
          smtpClient.EnableSsl = true;
          smtpClient.Credentials = new System.Net.NetworkCredential(config.StmpUsername, config.StmpPassword);
  
          await smtpClient.SendMailAsync(message);
          return true;
      }
      catch (Exception ex)
      {
          // 保留原始异常堆栈信息，不要重新包装
          throw;
      }
  }
  

3. 检查异步调用的等待逻辑 #

若调用SendEmailAsync时未添加await，任务会在后台执行，超时异常不会被当前上下文捕获，导致看起来“未进入catch”：

• 确保调用处正确使用await：

  await yourEmailService.SendEmailAsync(message, config);
  

• 修改catch块为直接throw，避免丢失原始异常的关键排查信息。

4. 容器DNS解析问题 #

Docker容器的DNS配置可能与本地不同，导致无法解析SMTP主机域名：

• 在容器内执行nslookup <你的SMTP主机>，验证域名是否能正常解析到IP；
• 若解析失败，可在Docker配置中指定公共DNS服务器（如在docker-compose.yml中添加dns: 8.8.8.8）。

5. SMTP服务器的IP拦截策略 #

部分邮件服务商或自建SMTP服务器会拦截来自Docker容器的IP（容器IP可能属于动态IP池或被标记为风险IP）：

• 将Docker主机的公网IP添加到SMTP服务器的白名单；
• 若使用第三方邮箱服务，确认是否需要开启专用SMTP权限（如开启“低安全性应用访问”或使用应用密码）。

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