连接本地IMAP服务器提示SSL证书主机名不匹配如何解决

错误根因 #

你遇到的证书不匹配报错是因为MDAEMON的IMAP服务配置的SSL证书中，绑定的主机名不是127.0.0.1。即使你Connect方法的第三个参数传了false（不直接使用SSL连接），如果服务器支持STARTTLS加密升级，ImapClient依然会自动启用TLS加密并校验证书合法性，就会触发该报错。
Outlook能正常连接是因为首次连接弹出证书不匹配警告时，你手动确认了信任该证书，相当于手动跳过了证书校验逻辑，而ImapClient默认执行严格的证书校验。

可行解决方案 #

方案1：使用和证书匹配的主机名连接（推荐） #

1. 打开MDAEMON的服务设置，查看IMAP服务绑定的SSL证书的主体名称，通常为localhost或者你配置的服务器域名
2. 将代码中连接地址从127.0.0.1替换为证书绑定的主机名即可，本地环境下localhost会自动解析为127.0.0.1，不会影响连接效率

方案2：本地测试临时关闭证书校验（生产环境禁止使用） #

在调用Connect方法前，给ImapClient配置自定义的证书校验回调，直接返回true跳过所有证书校验：

client.ServerCertificateValidationCallback = (sender, certificate, chain, sslPolicyErrors) => true;

方案3：更新证书添加127.0.0.1为备用名称 #

如果需要固定用127.0.0.1连接，可重新生成MDAEMON的SSL证书，在证书的使用者备用名称（SAN）字段中添加127.0.0.1，重新配置到IMAP服务后即可正常校验通过。

修正后的示例代码（本地测试用） #

private void loginbtn_Click(object sender, EventArgs e)
{
    using (var client = new ImapClient()) 
    {
        // 本地测试临时跳过证书校验，生产环境删除该行并使用方案1
        client.ServerCertificateValidationCallback = (s, cert, chain, errors) => true;
        client.Connect("127.0.0.1", 143, false);
        string email = emailbox.Text.ToString().Trim();
        string password = passwordbox.Text.ToString().Trim();
        client.Authenticate(email, password);
        var inbox = client.Inbox;
        inbox.Open(FolderAccess.ReadOnly);
        textBox1.Text = Convert.ToString(inbox.Count);
        recent.Text = Convert.ToString(inbox.Recent);
    }
}

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