.NET+React集成GitHub第三方登录持续返回401错误排查

我正在构建一个.NET+React应用，实现React通过.NET完成GitHub第三方登录功能，但调用GitHub的/user接口时始终收到401响应。

控制器中LoginWithGithub接口用于接收React端传来的授权码：

[HttpPost("github/login")]
public async Task<IActionResult> LoginWithGithub([FromBody] ExternalLoginDto dto)
{
    var AccessToken = await _githubHelper.GetAccessTokenAsync(dto.Code);
    var userData = await _githubHelper.GetUserAsync(AccessToken!);
    return Ok(userData);
}

调用GithubHelper能成功获取AccessToken，但调用GitHub /user接口请求失败。Helper代码如下：

public class GithubHelper
{
    private readonly IHttpClientFactory _httpClientFactory;
    private readonly IConfiguration _configuration;
    private readonly IHttpContextAccessor _contextAccessor;
    public GithubHelper(IHttpClientFactory httpClientFactory, IConfiguration configuration, IHttpContextAccessor contextAccessor)
    {
        _httpClientFactory = httpClientFactory;
        _configuration = configuration;
        _contextAccessor = contextAccessor;
    }

    public async Task<GitHubUser?> GetUserAsync(string token)
    {
        string userAgent = _contextAccessor?.HttpContext?.Request.Headers["User-Agent"]!;
        using var httpClient = new HttpClient();
        var request = new HttpRequestMessage(HttpMethod.Get, "https://api.github.com/user");
        request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
        request.Headers.Add("User-Agent", userAgent);

        HttpResponseMessage response = await httpClient.SendAsync(request);
        var content = await response.Content.ReadAsStringAsync();

        if (response.IsSuccessStatusCode)
        {
            var userInfo = JsonConvert.DeserializeObject<GitHubUser>(content);
            return userInfo;
        }
        else
        {
            throw new HttpRequestException($"GitHub API request failed with status code {response.StatusCode} and message {content}");
        }
    }


    public async Task<string?> GetAccessTokenAsync(string code)
    {
        var request = new HttpRequestMessage(HttpMethod.Post, "https://github.com/login/oauth/access_token")
        {
            Content = new FormUrlEncodedContent(new Dictionary<string, string>
            {
                {"client_id", _configuration["Github:ClientId"]!},
                {"client_secret", _configuration["Github:ClientSecret"]!},
                {"code", code}
            })
        };

        request.Headers.Add("Accept", "application/json");

        var client = _httpClientFactory.CreateClient();
        var response = await client.SendAsync(request);

        if (response.IsSuccessStatusCode)
        {
            var jsonContent = await response.Content.ReadAsStringAsync();
            var tokenResponse = JsonConvert.DeserializeObject<GitHubTokenResponse>(jsonContent);
            return tokenResponse?.access_token;
        }

        return null;
    }
}

已确认权限范围配置正确、数据无误，且偶尔在Postman中能正常工作，这是一个OAuth应用，请问出现该401错误的可能原因是什么？

可能的原因及排查方向 #

• User-Agent头异常：GitHub API强制要求携带合法的User-Agent头，当前代码依赖请求上下文获取该值，如果React端请求未传递或传递的User-Agent无效，会触发401。建议固定一个合法的User-Agent（比如应用名称），替换为request.Headers.Add("User-Agent", "MyDotNetReactApp/1.0")，避免依赖外部请求头。

• AccessToken无效或重复使用：GitHub授权码code仅能使用一次，重复使用同一code获取的token会无效；另外用户若撤销授权、token被回收也会导致401。需确保每次登录使用新的授权码，且在GetAccessTokenAsync返回null时直接返回错误，不要强行使用AccessToken!传递可能无效的值。

• HttpClient使用不当：GetUserAsync中每次创建新的HttpClient实例，可能引发连接池问题或请求头异常。建议复用IHttpClientFactory创建的客户端，和GetAccessTokenAsync保持一致，避免手动实例化HttpClient。

• redirect_uri不匹配：获取AccessToken时，若未传递redirect_uri参数，或参数值与GitHub OAuth应用后台配置的不一致，会导致获取的token权限异常。需在GetAccessTokenAsync的请求表单中添加{"redirect_uri", "你的回调地址"}，确保和后台配置完全一致（包括协议、域名、路径）。

• Token格式错误：检查AuthenticationHeaderValue的格式，确保Bearer与token之间有且仅有一个空格，token本身无多余空格、换行符。可在调用GetUserAsync前打印token值，验证格式正确性。

• HttpContext并发问题：IHttpContextAccessor在并发请求场景下可能获取到错误的上下文，导致User-Agent值异常。建议不要依赖HttpContext传递User-Agent，直接在代码中固定或从配置文件读取。

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