ASP.NET Core 2部署AWS后发送重置密码邮件失败求助

这种本地跑的好好的，一部署到AWS就掉链子的问题我见太多了，别慌，咱们一步步排查，先从最关键的地方入手：

1. 先抓具体错误日志（重中之重） #

别瞎猜原因，先拿到真实的异常信息才是关键。ASP.NET Core 2默认不会把详细错误返回给客户端，但你可以这么做：

• 查看AWS CloudWatch日志：如果你的API部署在EC2、ECS或者Elastic Beanstalk上，通常已经集成了CloudWatch日志，进去找API抛出的InnerException——比如是SMTP连接超时、认证失败还是端口被拒绝，这些细节能直接定位问题。
• 临时开启详细错误：在AWS的appsettings.json里把ASPNETCORE_ENVIRONMENT设为Development，或者在Startup.cs里配置详细错误页面（注意生产环境用完要改回去），这样就能看到具体的报错内容。

2. 检查SMTP端口与AWS安全组限制 #

AWS默认会限制EC2实例的25端口（防垃圾邮件），这是很多人踩坑的重灾区：

• 别用25端口！换成587（TLS）或者465（SSL）端口，绝大多数第三方SMTP服务（比如Gmail、Outlook）都支持这两个端口。
• 登录AWS控制台，找到你的EC2实例对应的安全组，确认已经开放了**出站（Outbound）**的587/465端口，目的地设为0.0.0.0/0或者SMTP服务器的IP范围。

3. 验证邮件服务配置的正确性 #

本地的配置可能没同步到AWS，或者AWS上的配置有细节错误：

• 检查AWS上的配置：不管是appsettings.json还是环境变量（比如Beanstalk的配置项、ECS的任务定义），SMTP的Host、Port、Username、Password必须和本地完全一致！尤其注意：有些邮箱（比如Gmail）开启两步验证后，必须用应用专用密码而不是账号密码。
• 确认代码里的SmtpClient配置顺序：一定要先关默认凭证，再设自定义凭证，否则会失效。示例代码：

using (var client = new SmtpClient(smtpHost, smtpPort))
{
    client.UseDefaultCredentials = false; // 先关默认
    client.Credentials = new NetworkCredential(smtpUser, smtpPass); // 再设自定义
    client.EnableSsl = true; // 绝大多数服务要求SSL/TLS
    await client.SendMailAsync(message);
}

4. 如果用AWS SES发送邮件，额外检查权限与模式 #

如果是用AWS SES作为邮件服务，还要注意两个坑：

• 你的SES账号是不是还在沙箱模式？沙箱里只能给已经验证过的邮箱发邮件，不能发给任意用户，要升级到生产模式需要提交AWS审核。
• 确认运行API的AWS资源（EC2/ECS/Lambda）有对应的IAM权限：给实例的IAM角色加上ses:SendEmail或ses:SendRawEmail的政策，不然会被拒绝访问SES。
• 发送邮件的From地址必须是SES里已经验证过的邮箱或域名，否则直接报错。

5. 手动测试SMTP连接 #

可以在AWS的EC2实例上用命令行测试网络连通性，排除网络问题：

# 测试587端口的TLS连接（以Gmail为例）
openssl s_client -connect smtp.gmail.com:587 -starttls smtp

如果连接失败，要么是安全组/网络ACL没开端口，要么是SMTP服务器把AWS的IP拉黑了。

内容的提问来源于stack exchange，提问作者Lucas Arruda