ASP.NET Core 7中Facebook第三方登录报错排查求助

一、先获取Facebook端的详细错误信息 #

Facebook的模糊500提示没有实际排查价值，必须拿到具体错误细节：

• 登录Facebook开发者后台进入你的应用，找到应用日志（在「仪表板」或「事件管理器」模块中），查看OAuth相关的错误记录，里面会包含具体错误代码与描述（比如invalid_redirect_uri、unsupported_api_version等）。
• 手动修改日志中的Facebook授权地址，添加&debug=all参数后访问，直接查看返回的详细错误内容。

二、验证Facebook应用核心配置 #

• 应用状态与测试用户：如果应用处于「开发模式」，只有添加到应用「测试用户」列表的账号才能正常登录，普通账号会触发错误；若要开放给普通用户使用，需将应用提交审核转为「上线模式」。
• 回调地址精确匹配：将日志中的redirect_uri（https://localhost:7098/signin-facebook）完整复制到Facebook后台的「产品 > Facebook登录 > 设置 > 有效的OAuth重定向URI」中，确保完全一致（包括https协议、端口、路径，不能多/少斜杠）。
• AppId与AppSecret校验：重新复制Facebook应用的AppId和AppSecret到配置文件，避免复制时混入空格或特殊字符；可在Facebook后台「设置 > 基本」页面再次确认这些值。
• 权限设置：检查请求的email权限是否已在应用中启用，开发模式下测试用户无需审核即可使用，但需确保权限未被禁用。

三、适配Facebook API版本 #

日志显示当前使用的是Facebook API v11.0，该版本已被官方淘汰，会直接导致请求失败：
在AddFacebook配置中手动指定最新的API版本（当前推荐v18.0）：

builder.Services.AddAuthentication()
    .AddFacebook(options =>
    {
        IConfigurationSection FBAuthNSection = config.GetSection("Authentication:Facebook");
        options.AppId = FBAuthNSection["AppId"];
        options.AppSecret = FBAuthNSection["AppSecret"];
        options.SaveTokens = true;
        // 指定最新API版本
        options.AuthorizationEndpoint = "https://www.facebook.com/v18.0/dialog/oauth";
        options.TokenEndpoint = "https://graph.facebook.com/v18.0/oauth/access_token";
        options.UserInformationEndpoint = "https://graph.facebook.com/v18.0/me?fields=id,name,email";
    });

四、排除本地环境问题 #

• HTTPS证书有效性：虽然localhost自签名证书在开发环境通常可用，但可尝试使用ngrok将本地服务暴露为公网HTTPS地址，替换回调地址后测试，排除本地证书或网络拦截问题。
• 回调端点可访问性：确保本地服务的/signin-facebook端点能正常访问，没有被防火墙或自定义中间件拦截；可直接访问该地址，确认返回400状态码（正常，因为缺少授权参数）而非500。

五、强化ASP.NET日志排查 #

当前日志仅记录了挑战阶段，需确保能捕获回调阶段的所有信息：

• 调整日志配置，扩大认证流程的日志覆盖范围：

{
  "DetailedErrors": true,
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Trace",
      "Microsoft.AspNetCore.Authentication": "Trace"
    }
  }
}

• 添加自定义中间件捕获回调请求参数：在Program.cs中插入以下代码，打印/signin-facebook请求的所有查询参数，若Facebook返回错误参数（如error、error_description），会在这里直接显示：

app.Use(async (context, next) =>
{
    if (context.Request.Path == "/signin-facebook")
    {
        var queryParams = context.Request.Query.ToString();
        Console.WriteLine($"Signin-Facebook Callback Params: {queryParams}");
    }
    await next();
});

内容的提问来源于stack exchange，提问作者Gábor Haraszti