ASP.NET Core部署到服务器后发邮件提示切换开发环境如何解决

第一步：获取完整错误信息 #

你当前看到的是ASP.NET Core生产环境的默认错误提示，系统出于安全考虑隐藏了具体异常栈，先拿到具体报错才能精准定位：

• 临时将服务器上的ASPNETCORE_ENVIRONMENT环境变量值修改为Development，重启应用后再次触发发送操作，就能看到完整的异常详情
• 排查完成后立刻将环境变量改回Production，避免生产环境泄露敏感信息
• 也可以提前配置日志组件将异常输出到文件/数据库，不用切换环境就能排查问题

第二步：针对邮件发送场景的常见问题排查 #

本地运行正常但服务器失败，绝大多数是服务器环境或第三方SMTP权限限制导致，按以下优先级排查：

1. 谷歌SMTP权限校验问题 #

谷歌对非信任环境的SMTP请求拦截规则非常严格，这是最常见的故障原因：

• 普通谷歌账号已不再支持直接用账号密码调用SMTP，必须先为账号开启两步验证，然后生成应用专用密码替换代码里的登录密码
• 登录你的谷歌邮箱，查看是否有来自服务器IP的异常登录拦截提醒，按提示将服务器IP添加为信任地址
• 如果是谷歌企业Workspace账号，需要额外在后台开启SMTP中继权限，同时将服务器IP加入白名单

2. 服务器出站端口限制 #

绝大多数云服务商默认会封禁25、587等邮件端口的出站流量：

• 检查服务器安全组、系统防火墙的出站规则，确认已放行587端口的TCP出站请求
• 部分云厂商会直接封禁25端口，可尝试将SMTP端口改为465，保持EnableSsl = true配置不变测试

3. 代码兼容与配置问题 #

• 你当前使用的SmtpClient类已被微软官方标记为弃用，跨平台部署到Linux服务器时存在兼容性缺陷，建议替换为官方推荐的MailKit库实现邮件发送
• 谷歌SMTP强制要求发件人地址必须和认证的邮箱账号一致，你当前代码中mail.From使用用户提交的邮箱，会被谷歌直接拦截，修改逻辑为：mail.From固定填你自己的认证邮箱，将用户邮箱添加到ReplyTo列表，既满足谷歌规则，也不影响回复邮件给发件人
• 不要硬编码邮箱账号密码，建议放到配置文件或环境变量中，避免部署时配置遗漏

临时验证方案 #

可以先在服务器上用telnet命令测试SMTP连通性，确认网络层面没有问题：
telnet smtp.gmail.com 587
如果连接失败就是网络/端口问题，连接成功就是权限或代码问题。

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