如何解决MailKit向Gmail发送邮件时的5.5.2语法错误？

错误信息 #

MailKit.Net.Smtp.SmtpCommandException: „5.5.2 Syntax error, cannot decode response. For more information, go to https://support.google.com/a/answer/3221692 and review RFC 5321 specifications. a640c23a62f3a-a99efe3caebsm81376566b.16 - gsmtp”

问题分析 #

你的代码存在几个关键问题，直接或间接导致了SMTP语法错误：

• 数组越界风险：nums数组仅包含9个元素（索引0-8），但rnd.Next(0,10)会生成0-9的随机数，取到索引9时会触发数组越界异常，破坏程序执行流程或邮件内容。
• 变量名不匹配：生成的验证码存储在rescuePasswordVericationCode中，但邮件内容引用未定义的verificationCode，导致邮件内容异常，引发SMTP服务器解析错误。
• SMTP连接配置错误：Gmail的587端口要求TLS加密，你传入false跳过加密，导致协议握手失败，触发语法解析错误。
• 异步方法误用：在Task.Run中使用同步SMTP方法，既阻塞线程又无法正确捕获异常，可能导致未处理崩溃。

修正后的代码 #

private async void RescuePassword(object sender, EventArgs e)
{
    // 补充0，避免数组越界
    string[] nums = ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0"];
    if (listBox1.SelectedIndex == -1)
    {
        MessageBox.Show("No password selected", "No password selected", MessageBoxButtons.OK, MessageBoxIcon.Error);
        return;
    }

    rescuePasswordVericationCode = "";
    // 使用数组长度控制随机数范围，避免硬编码
    for (int _ = 0; _ < 4; _++)
    {
        rescuePasswordVericationCode += nums[rnd.Next(0, nums.Length)];
    }
    
    try
    {
        MimeMessage gmailMessage = new();
        // 修正发件人名称拼写错误
        gmailMessage.From.Add(new MailboxAddress("Safety", "thatonegmail@gmail.com"));
        gmailMessage.To.Add(new MailboxAddress("Client", textBox2.Text));
        gmailMessage.Subject = "Verification code";

        gmailMessage.Body = new TextPart("plain")
        {
            // 使用正确的变量名
            Text = $"Your verification code is {rescuePasswordVericationCode}"
        };

        using (SmtpClient client = new SmtpClient())
        {
            // 启用StartTLS加密连接，符合Gmail要求
            await client.ConnectAsync("smtp.gmail.com", 587, SecureSocketOptions.StartTls);
            // 使用Gmail应用专用密码（需开启两步验证）
            await client.AuthenticateAsync("thatonegmail@gmail.com", "your-real-app-password");
            await client.SendAsync(gmailMessage);
            await client.DisconnectAsync(true);
        }
        MessageBox.Show("Verification code sent successfully!", "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Error sending email: {ex.Message}", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

额外注意事项 #

• Gmail账号配置：必须开启账号两步验证，创建应用专用密码用于SMTP登录，直接使用原账号密码会被Google拦截。
• 异常处理：添加try-catch块捕获发送过程中的异常，避免程序崩溃并给用户明确提示。
• 异步规范：使用MailKit提供的异步方法（带Async后缀）配合await，避免阻塞UI线程，提升用户体验。

内容的提问来源于stack exchange，提问作者new csharp'er