ASP.NET Core集成Google登录回调报错：OAuth状态缺失或无效

核心问题 #

你遇到的The oauth state was missing or invalid错误，以及无法进入自定义SignInGoogle方法的根本原因是：

• ASP.NET Core的Google OAuth中间件会自动处理CallbackPath指定的路径，不会将请求转发到你的控制器方法
• 配置中的RedirectUri和CallbackPath存在逻辑冲突，同时中间件顺序可能不符合规范

修复步骤 #

1. 调整认证中间件配置 #

修改Program.cs中的Google认证配置，移除手动指定的RedirectUri，让中间件自动处理回调流程；同时确保CallbackPath与Google云控制台配置的回调地址完全一致：

builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie(options => 
    {
        options.LoginPath = "/api/authorization/login";
        // 本地开发或跨域场景下，补充Cookie配置避免丢失
        options.Cookie.SameSite = SameSiteMode.Lax;
        options.Cookie.SecurePolicy = CookieSecurePolicy.Always;
    })
    .AddGoogle(options =>
    {
        options.SignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.CallbackPath = "/api/authorization/google/signin";

        options.ClientId = builder.Configuration["Authentication:Google:ClientId"];
        options.ClientSecret = builder.Configuration["Authentication:Google:ClientSecret"];

        options.Scope.Add("email");
        options.Scope.Add("profile");
        
        // 通过事件处理替代原自定义SignInGoogle方法的逻辑
        options.Events = new OAuthEvents
        {
            OnCreatingTicket = async context =>
            {
                // 此处可获取Google返回的用户信息
                var email = context.Identity.FindFirstValue(ClaimTypes.Email);
                var name = context.Identity.FindFirstValue(ClaimTypes.Name);
                
                // 执行自定义业务逻辑，比如创建本地用户、添加自定义Claims等
                // ...
                
                await Task.CompletedTask;
            },
            OnTicketReceived = context =>
            {
                // 认证成功后跳转至前端目标页面
                context.ReturnUri = "https://your-frontend-domain.com/auth-success";
                return Task.CompletedTask;
            }
        };
    });

2. 修正中间件加载顺序 #

在Program.cs的应用配置部分，确保UseHttpsRedirection在认证中间件之前加载：

app.UseHttpsRedirection();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "***"));
}

app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();

3. 简化控制器Login方法 #

移除手动指定的RedirectUri，让中间件自动处理跳转逻辑：

[Route("api/authorization/google")]
[ApiController]
public class GoogleAuthorizationController : ControllerBase
{
    [HttpGet("login")]
    public IActionResult LoginGoogle()
    {
        var properties = new AuthenticationProperties();
        // 若需携带自定义状态，可在此添加
        // properties.Items.Add("CustomState", "your-custom-value");
        
        return Challenge(properties, GoogleDefaults.AuthenticationScheme);
    }

    // 删除原SignInGoogle方法，该路径由OAuth中间件自动处理
}

4. 验证Google云控制台配置 #

确保控制台中授权重定向URI与代码中CallbackPath完全匹配，本地开发时格式示例：
https://localhost:xxxx/api/authorization/google/signin（替换为你的实际端口）

5. 本地开发额外注意事项 #

• 强制使用HTTPS，Google OAuth不支持HTTP回调（可在launchSettings.json中启用HTTPS）
• 清除浏览器缓存与Cookie，避免旧的state值干扰认证流程

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