ASP.NET Core中UserManager.FindByNameAsync查存在用户返回null问题

问题场景 #

调用UserManager.FindByNameAsync时，数据库中存在完全匹配的用户，但方法返回null，导致无法获取用户角色。

核心代码 #

public async Task<string> GetUserRolesByUserId(string userName)
{
    var user = await _userManager.FindByNameAsync(userName);
    
    if (user == null)
    {
        return "";
    }

    var roles = await _userManager.GetRolesAsync(user);
    return string.Join(",", roles);
}

预期与实际行为 #

• 预期：找到用户“TonyMontana”并返回其角色列表
• 实际：FindByNameAsync针对“TonyMontana”返回null，数据库中存在用户名完全一致的用户

已确认信息 #

• 数据库中确实存在“TonyMontana”用户
• 传入参数与数据库用户名大小写完全匹配
• UserManager已在启动类中配置

疑问 #

不确定是大小写敏感问题，还是UserManager配置/使用错误导致？

更新：Program.cs配置代码 #

using System.Text;
using Database;
using Database.Models;
using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.AspNetCore.Identity;
using Microsoft.IdentityModel.Tokens;
using WebApi.Setup;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();
builder.Services.AddAutoMapper(typeof(Program));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddDbContext<MyDbContext>();

var secretKey= builder.Configuration["JwtConfig:JWTSecretKey"];

if(string.IsNullOrEmpty(secretKey)) 
{
    secretKey= "XXX-123-YYY-456";
}

// Register JWTService with the necessary dependencies
builder.Services.AddScoped<JWTService>(provider => 
    {
        var userManager = provider.GetRequiredService<UserManager<Users>>();
        return new JWTService(secretKey, userManager);
    });

builder.Services.AddIdentity<Users, IdentityRole>()
    .AddEntityFrameworkStores<MyDbContext>()
    .AddDefaultTokenProviders();

builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
})
.AddJwtBearer(options =>
{
    options.TokenValidationParameters = new TokenValidationParameters
    {
        ValidateIssuerSigningKey = true,
        IssuerSigningKey = new SymmetricSecurityKey(
            Encoding.UTF8.GetBytes(secretKey)),
        ValidateIssuer = false,
        ValidateAudience = false,
        ValidateLifetime = true,
        ClockSkew= TimeSpan.Zero
    };
});

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

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

app.MapControllers();
app.Run();

排查方向与解决方案 #

1. 检查数据库排序规则的大小写敏感性

   • 若使用SQL Server，查询数据库排序规则确认是否区分大小写：

     SELECT name, collation_name FROM sys.databases WHERE name = '你的数据库名';
     

   • 若排序规则为区分大小写（如SQL_Latin1_General_CP1_CS_AS），可修改数据库/表排序规则，或统一代码与数据库的大小写处理逻辑。

2. 验证Users实体与UserStore配置

   • 确认Users实体的UserName属性符合Identity框架要求，未自定义UserStore覆盖默认查询逻辑。
   • 检查是否配置了自定义IdentityOptions，比如修改了用户名验证规则：

     builder.Services.Configure<IdentityOptions>(options =>
     {
         options.User.AllowedUserNameCharacters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._@+";
         options.User.RequireUniqueEmail = true;
     });
     

3. 确认UserManager注入与上下文正确性

   • 确保_userManager通过依赖注入获取，而非手动实例化；检查MyDbContext的连接字符串指向正确数据库。
   • 开启EF Core日志，查看FindByNameAsync执行的SQL语句，确认查询逻辑是否正确。

4. 检查用户状态

   • 确认数据库中用户的LockoutEnabled、LockoutEnd等字段，排除用户被锁定或标记为异常状态的情况。

5. 替换查询方式测试

   • 用直接查询替代FindByNameAsync，判断问题来源：

     var user = await _userManager.Users.FirstOrDefaultAsync(u => u.UserName == userName);
     

     若此方法能获取用户，说明UserManager的默认查询逻辑被自定义覆盖，需检查相关配置。

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