.NET桌面应用OAuth2认证时无法从重定向URL获取授权码

问题根源分析 #

你的代码卡住的核心原因有几个：

• HTTPS监听缺少SSL证书绑定：HttpListener监听HTTPS地址时，必须提前绑定对应端口的SSL证书，否则浏览器访问https://localhost:7270会触发安全错误，无法发送请求到listener，导致GetContextAsync()一直处于等待状态。
• 变量名错误：AuthenticateUser方法中定义的是redirect变量，但拼接授权URL时误用了未定义的redirectUrl，会导致编译错误，授权URL生成失败。
• 未处理浏览器响应：收到请求后未给浏览器返回任何响应，浏览器会一直挂起，同时listener的上下文处理流程不完整。
• 未使用取消令牌：InvokeAsync中的CancellationToken未传递给GetContextAsync，无法在需要时主动取消监听操作。

修复步骤与代码示例 #

1. 绑定SSL证书（针对HTTPS监听）

以管理员身份打开PowerShell，执行以下命令绑定证书到7270端口（先通过certlm.msc在个人>证书中找到localhost证书的Thumbprint）：

netsh http add sslcert ipport=0.0.0.0:7270 certhash=你的证书Thumbprint appid={随机GUID}

如果不想处理HTTPS证书，可直接改用HTTP协议（重定向URL改为http://localhost:7270/discord/auth），开发环境下更简便。

2. 修正变量名与授权URL生成

public class Authenticate
{
    private Browser _browser;

    public async Task AuthenticateUser()
    {
        _browser = new();

        string redirect = "https://localhost:7270/discord/auth";
        // 修正变量名错误，使用正确的redirect变量拼接URL
        string url = $"https://discord.com/oauth2/authorize?response_type=code&client_id={YourClientId}&scope={YourScopes}&redirect_uri={HttpUtility.UrlEncode(redirect)}";

        BrowserOptions options = new(url, "https://localhost:7270/");

        BrowserResult result = await _browser.InvokeAsync(options, default);
        // 提取授权码
        if (!string.IsNullOrEmpty(result.Response))
        {
            var code = HttpUtility.ParseQueryString(new Uri(result.Response).Query)["code"];
            // 此处可继续处理授权码，比如换取访问令牌
        }
    }
}

3. 完善Browser类的监听逻辑

public class Browser : IBrowser
{
    public async Task<BrowserResult> InvokeAsync(BrowserOptions options, CancellationToken cancellationToken)
    {
        Process.Start(new ProcessStartInfo(options.StartUrl) { UseShellExecute = true });

        var result = new BrowserResult();

        using (var listener = new HttpListener())
        {
            var listenUrl = options.EndUrl;
            // 确保前缀以/结尾（HttpListener强制要求）
            if (!listenUrl.EndsWith("/"))
                listenUrl += "/";
            listener.Prefixes.Add(listenUrl);
            listener.Start();

            try
            {
                // 传递取消令牌，支持主动取消监听
                var context = await listener.GetContextAsync().WaitAsync(cancellationToken);

                // 提取完整的重定向URL
                result.Response = context.Request.Url.AbsoluteUri;

                // 给浏览器返回成功响应，避免浏览器挂起
                var response = context.Response;
                string responseString = "<html><body>认证成功，可关闭此页面</body></html>";
                byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
                response.ContentLength64 = buffer.Length;
                var output = response.OutputStream;
                await output.WriteAsync(buffer, cancellationToken);
                output.Close();

                return result;
            }
            catch (OperationCanceledException)
            {
                result.Cancelled = true;
                return result;
            }
            catch (Exception ex)
            {
                result.Error = ex.Message;
                return result;
            }
            finally
            {
                listener.Stop();
            }
        }
    }
}

// 补充必要的类定义（若未提前定义）
public class BrowserOptions
{
    public string StartUrl { get; }
    public string EndUrl { get; }

    public BrowserOptions(string startUrl, string endUrl)
    {
        StartUrl = startUrl;
        EndUrl = endUrl;
    }
}

public class BrowserResult
{
    public string Response { get; set; }
    public bool Cancelled { get; set; }
    public string Error { get; set; }
}

public interface IBrowser
{
    Task<BrowserResult> InvokeAsync(BrowserOptions options, CancellationToken cancellationToken);
}

额外注意事项 #

• 确保Discord开发者后台配置的重定向URL和代码中的完全一致，包括协议（HTTP/HTTPS）、端口和路径。
• 处理完授权码后，listener会自动停止并释放资源，避免端口长期占用。

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