ASP.NET Core中OAuth2与Identity结合：移除默认登录路由并使用UserManager

核心问题分析 #

你的问题出在默认Cookie认证方案仍指向Identity的用户名密码登录路径，未将OAuth2设置为默认的挑战登录方式。以下是具体配置和实现步骤：

步骤1：正确配置Identity服务（禁用默认登录UI与用户名密码方案） #

在Program.cs中添加Identity服务时，只保留用户/角色管理所需组件，禁用默认登录注册UI：

builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = false)
    .AddRoles<IdentityRole>()
    .AddUserManager<UserManager<IdentityUser>>()
    .AddRoleManager<RoleManager<IdentityRole>>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

// 关键配置：将Cookie认证的默认挑战方案设为你的OAuth2方案
builder.Services.ConfigureApplicationCookie(options =>
{
    options.ChallengeScheme = "Google"; // 替换为你实际使用的OAuth2方案名（如GitHub、Microsoft）
    // 可选：自定义登录入口路径，替代默认的/Account/Login
    // options.LoginPath = "/auth/externallogin";
});

步骤2：配置OAuth2认证服务 #

以Google OAuth2为例，添加认证服务并处理用户关联逻辑（确保OAuth2登录的用户能被Identity的UserManager识别）：

builder.Services.AddAuthentication()
    .AddGoogle(options =>
    {
        // 从配置文件读取OAuth2凭证
        options.ClientId = builder.Configuration["Authentication:Google:ClientId"];
        options.ClientSecret = builder.Configuration["Authentication:Google:ClientSecret"];
        options.CallbackPath = "/signin-google"; // 回调路径需与OAuth2平台配置一致

        // 登录成功后，创建或关联Identity用户
        options.Events.OnCreatingTicket = async context =>
        {
            var email = context.Identity.FindFirstValue(ClaimTypes.Email);
            var userManager = context.HttpContext.RequestServices.GetRequiredService<UserManager<IdentityUser>>();
            
            // 查找已有用户，不存在则创建
            var user = await userManager.FindByEmailAsync(email);
            if (user == null)
            {
                user = new IdentityUser { UserName = email, Email = email };
                var createResult = await userManager.CreateAsync(user);
                if (!createResult.Succeeded)
                {
                    throw new InvalidOperationException($"创建用户失败：{string.Join(", ", createResult.Errors.Select(e => e.Description))}");
                }
                // 可选：给新用户分配默认角色
                await userManager.AddToRoleAsync(user, "BasicUser");
            }

            // 将Identity用户ID添加到Claims，方便后续通过UserManager操作
            var userId = await userManager.GetUserIdAsync(user);
            context.Identity.AddClaim(new Claim(ClaimTypes.NameIdentifier, userId));
        };
    });

步骤3：确保中间件顺序正确 #

在Program.cs的管道配置中，认证中间件必须在授权中间件之前：

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

// 其他中间件配置
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
// 注意：如果不需要Identity的Razor页面，不要调用app.MapRazorPages()，避免默认/Account路由被注册

步骤4：使用UserManager执行CRUD操作 #

在控制器或服务中直接注入UserManager<IdentityUser>和RoleManager<IdentityRole>即可操作用户与角色：

public class UserManagementController : Controller
{
    private readonly UserManager<IdentityUser> _userManager;
    private readonly RoleManager<IdentityRole> _roleManager;

    public UserManagementController(UserManager<IdentityUser> userManager, RoleManager<IdentityRole> roleManager)
    {
        _userManager = userManager;
        _roleManager = roleManager;
    }

    // 获取所有用户
    public async Task<IActionResult> AllUsers()
    {
        var users = await _userManager.Users.ToListAsync();
        return View(users);
    }

    // 给用户添加角色
    [HttpPost]
    public async Task<IActionResult> AssignRole(string userId, string roleName)
    {
        var user = await _userManager.FindByIdAsync(userId);
        if (user == null) return NotFound("用户不存在");

        // 角色不存在则创建
        if (!await _roleManager.RoleExistsAsync(roleName))
        {
            await _roleManager.CreateAsync(new IdentityRole(roleName));
        }

        var result = await _userManager.AddToRoleAsync(user, roleName);
        if (result.Succeeded)
        {
            return RedirectToAction(nameof(AllUsers));
        }

        foreach (var error in result.Errors)
        {
            ModelState.AddModelError("", error.Description);
        }
        return View();
    }
}

关键注意事项 #

• 确保OAuth2平台的回调路径（如/signin-google）与代码配置一致，且已在平台后台添加
• 若不需要Identity的任何UI页面，不要添加AddDefaultUI()或MapRazorPages()，避免默认/Account路由被注册
• 使用其他OAuth2提供商（如GitHub、Microsoft）时，替换AddGoogle为对应方法（AddGitHub、AddMicrosoftAccount）并调整凭证配置

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