本地MailTrap邮件发送正常，Azure部署后抛出ArgumentNullException

错误根源定位 #

根据错误提示，MailboxAddress构造函数的address参数为null，对应代码中两处调用：

• new MailboxAddress(_mailSettings.SenderName, _mailSettings.SenderEmail)：第二个参数_mailSettings.SenderEmail为空
• new MailboxAddress(mailData.EmailToName, mailData.EmailToId)：第二个参数mailData.EmailToId为空

本地正常、部署后异常，大概率是Azure环境配置缺失或前端参数传递异常。

解决步骤 #

1. 检查Azure应用服务配置项 #

登录Azure门户，进入你的应用服务：

• 打开「配置」→「应用程序设置」
• 确认MailSettings相关配置项已添加且值不为空：
  • MailSettings:SenderName
  • MailSettings:SenderEmail
  • MailSettings:Server
  • MailSettings:Port
  • MailSettings:UserName
  • MailSettings:Password
    本地的appsettings.json配置不会自动同步到Azure，需手动添加这些敏感配置项（避免把密码等信息提交到代码仓库）。

2. 验证前端传递的mailData参数 #

在SendMailAsync方法开头添加日志，记录收件人信息：

logger.LogInformation("邮件请求参数：EmailToName={Name}, EmailToId={Email}", mailData.EmailToName, mailData.EmailToId);

然后在Azure应用服务的「日志」→「日志流」中查看日志，确认EmailToId是否为空。如果为空，检查前端表单提交逻辑，确保收件人邮箱字段正确传递。

3. 添加参数校验逻辑 #

在SendMailAsync方法开头添加非空校验，提前拦截错误：

if (string.IsNullOrWhiteSpace(_mailSettings.SenderEmail))
    throw new ArgumentNullException(nameof(_mailSettings.SenderEmail), "发件人邮箱不能为空");
if (string.IsNullOrWhiteSpace(mailData.EmailToId))
    throw new ArgumentNullException(nameof(mailData.EmailToId), "收件人邮箱不能为空");

这样能明确抛出具体参数的空值错误，便于排查。

4. Azure服务器端调试方法 #

• 远程调试：在Azure门户应用服务的「开发工具」→「高级工具」→「Go」进入Kudu控制台，或在Visual Studio中直接连接Azure应用服务开启远程调试（需在应用服务配置中启用远程调试选项）。
• 查看详细日志：在应用服务「监控」→「日志」中启用应用日志记录，设置日志级别为Debug，可查看完整异常堆栈，精准定位报错代码行。

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