C#应用使用MailBee.Net通过OAuth2连接Gmail遭认证失败（MBN00000002）

核心问题定位 #

你当前代码使用的GoogleWebAuthorizationBroker依赖浏览器交互完成授权，完全不适合无GUI环境，这是导致MBN00000002 [AUTHENTICATIONFAILED]错误的主要原因。此外，连接Gmail服务器时未明确指定SSL加密和正确端口，也可能加剧认证失败问题。

修正方案 #

1. Google控制台配置确认 #

• 确保应用类型设置为桌面应用（而非Web应用）
• 登录目标Gmail账号，开启IMAP/POP3访问：设置 → 转发和POP/IMAP → 启用对应协议
• 确认已添加https://mail.google.com/权限范围（该范围是访问Gmail邮件系统的必需项）

2. 改用无GUI适配的设备授权流 #

对于无桌面交互的应用，Google推荐使用设备授权流：用户只需在任意设备的浏览器中输入验证码即可完成授权，无需本地GUI支持。

3. 修正后的完整代码 #

using System;
using System.Threading;
using Google.Apis.Auth.OAuth2;
using MailBee;
using MailBee.ImapMail;

public class Program
{
    public static void Main(string[] args)
    {
        // 必需的权限范围
        string[] scopes = new string[] { "https://mail.google.com/" };

        // 初始化OAuth2设备授权流
        var flow = new GoogleAuthorizationCodeFlow(new GoogleAuthorizationCodeFlow.Initializer
        {
            ClientSecrets = new ClientSecrets
            {
                ClientId = "你的Client ID",
                ClientSecret = "你的Client Secret"
            },
            Scopes = scopes,
            DataStore = new FileDataStore("GmailOAuthTokenStore") // 持久化token到本地，避免重复授权
        });

        // 获取设备授权信息
        var deviceCode = flow.LoadDeviceCodeAsync(scopes, CancellationToken.None).Result;

        // 输出授权提示（无GUI环境下可通过日志/控制台传递给用户）
        Console.WriteLine($"请在浏览器打开：{deviceCode.VerificationUrl}");
        Console.WriteLine($"输入验证码：{deviceCode.UserCode}");
        Console.WriteLine("等待用户完成授权...");

        // 等待用户授权并获取凭证
        UserCredential credential = new UserCredential(flow, "user", 
            flow.ExchangeDeviceCodeAsync(deviceCode, CancellationToken.None).Result);

        // 检查并刷新过期token
        if (credential.Token.IsExpired(flow.Clock))
        {
            Console.WriteLine("Token已过期，正在刷新...");
            if (!credential.RefreshTokenAsync(CancellationToken.None).Result)
            {
                Console.WriteLine("Token刷新失败");
                return;
            }
            Console.WriteLine("Token刷新成功");
        }

        // 生成MailBee兼容的XOAuth2密钥
        string xoauthKey = OAuth2.GetXOAuthKeyStatic("你的Gmail邮箱地址", credential.Token.AccessToken);

        // 连接Gmail IMAP服务器（强制SSL，指定标准端口993）
        Imap imp = new Imap();
        imp.Log.Enabled = true;
        imp.Log.Filename = @"C:\APP_BCK\log.txt";
        imp.Log.HidePasswords = false;
        imp.Log.Clear();

        imp.Connect("imap.gmail.com", 993, true);

        // 执行SaslOAuth2认证
        imp.Login(null, xoauthKey, AuthenticationMethods.SaslOAuth2, 
            MailBee.AuthenticationOptions.None, null);
        
        imp.SelectFolder("INBOX");
        Console.WriteLine($"收件箱共有{imp.MessageCount}封邮件");
        imp.Disconnect();
    }
}

4. POP3适配说明 #

如果需要使用POP3协议，只需将IMAP相关代码替换为POP3类，POP3的SSL端口为995，认证方式保持SaslOAuth2即可。

额外注意事项 #

• 首次运行时，程序会输出授权网址和验证码，用户完成授权后，token会被持久化到本地，后续运行无需重复授权
• 确保使用最新版本的MailBee.Net Object DLL，避免OAuth2兼容性问题

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