.NET Core API中OpenIddict无法返回Token的问题排查

问题根源 #

错误The entity type 'OpenIddictEntityFrameworkCoreToken' was not found的核心原因有两点：

• 你的ApplicationDbContext未将OpenIddict所需的实体纳入EF Core数据模型，导致EF无法识别对应的数据库表结构
• 你注释掉了ASP.NET Core Identity的核心服务注册，既会导致UserManager/SignInManager依赖注入失败，也会破坏OpenIddict与Identity的集成配置

解决方案 #

1. 恢复并正确配置ASP.NET Core Identity服务 #

你的AuthorizationController中明确用到了_userManager和_signInManager，必须恢复Identity服务注册：

// 注册Identity服务，确保泛型类型匹配你的自定义用户和角色类
builder.Services.AddIdentity<ApplicationUser, IdentityRole>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

2. 确保OpenIddict实体被EF Core识别 #

如果你的ApplicationDbContext继承自IdentityDbContext<ApplicationUser, IdentityRole, string>，那么通过options.UseOpenIddict()已经自动将OpenIddict实体纳入模型。如果不是，需手动添加对应DbSet：

public class ApplicationDbContext : IdentityDbContext<ApplicationUser, IdentityRole, string>
{
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
        : base(options)
    {
    }

    // 手动添加OpenIddict实体的DbSet（继承IdentityDbContext时可省略）
    public DbSet<OpenIddictEntityFrameworkCoreApplication> Applications { get; set; }
    public DbSet<OpenIddictEntityFrameworkCoreAuthorization> Authorizations { get; set; }
    public DbSet<OpenIddictEntityFrameworkCoreScope> Scopes { get; set; }
    public DbSet<OpenIddictEntityFrameworkCoreToken> Tokens { get; set; }
}

3. 执行EF Core迁移生成数据库表 #

OpenIddict需要专用表存储令牌、授权等数据，执行以下命令创建并应用迁移：

# 创建新迁移文件
dotnet ef migrations add AddOpenIddictTables

# 将迁移应用到数据库
dotnet ef database update

4. 完善中间件配置 #

确保Program.cs中身份验证中间件的顺序正确（必须在路由中间件之前）：

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

app.MapControllers();

5. 补充控制器错误处理逻辑 #

为AuthorizationController的错误分支添加符合OpenIddict规范的响应：

if (user == null)
{
    return Forbid(
        authenticationSchemes: OpenIddictServerAspNetCoreDefaults.AuthenticationScheme,
        properties: new AuthenticationProperties(new Dictionary<string, string>
        {
            [OpenIddictServerAspNetCoreConstants.Properties.Error] = OpenIddictConstants.Errors.InvalidGrant,
            [OpenIddictServerAspNetCoreConstants.Properties.ErrorDescription] = "用户名或密码错误"
        }));
}

if (!result.Succeeded)
{
    return Forbid(
        authenticationSchemes: OpenIddictServerAspNetCoreDefaults.AuthenticationScheme,
        properties: new AuthenticationProperties(new Dictionary<string, string>
        {
            [OpenIddictServerAspNetCoreConstants.Properties.Error] = OpenIddictConstants.Errors.InvalidGrant,
            [OpenIddictServerAspNetCoreConstants.Properties.ErrorDescription] = "用户名或密码错误"
        }));
}

验证 #

完成以上步骤后重启API，用Postman请求/connect/token端点，即可正常获取Token响应。

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