迁移至.NET Core 2.0时OpenIddict返回unsupported_grant_type错误求助

问题背景 #

你在从.NET Core 1.1迁移到2.0的过程中，更新认证逻辑采用OAuth+OpenIddict方案，但调用connect/token接口时收到了报错：

OpenIddict.Server.OpenIddictServerHandler[0] The token response was successfully returned: {
"error": "unsupported_grant_type",
"error_description": "The specified 'grant_type' parameter is not supported."
}.

你已经贴出了请求代码和AuthorizationController的Exchange方法，并且确认生成了AuthenticationTicket并返回，但还是触发了这个错误。我帮你梳理几个最可能的原因和排查步骤：

可能的原因及解决办法 #

1. OpenIddict服务未启用Client Credentials授权流 #

这是最常见的问题：如果在Startup的OpenIddict配置里没有明确允许client_credentials这种授权类型，OpenIddict会直接拒绝这类请求。

打开你的Startup.cs，找到ConfigureServices里的OpenIddict配置代码，确保加上AllowClientCredentialsFlow()：

services.AddOpenIddict()
    // 注册OpenIddict服务器组件
    .AddServer(options =>
    {
        // 关键：允许client_credentials授权类型
        options.AllowClientCredentialsFlow();
        
        // 其他必要配置，比如指定token端点、签名密钥等
        options.SetTokenEndpointUris("/connect/token");
        options.AddEphemeralEncryptionKey()
               .AddEphemeralSigningKey();
        options.UseAspNetCore()
               .EnableTokenEndpointPassthrough();
    })
    // 必须注册MVC绑定器，否则请求参数无法正确解析
    .AddMvcBinders();

2. OpenIddict的MVC绑定器未正确注册 #

你的Exchange方法里的Debug.Assert已经提示了这点：如果没注册这个绑定器，OpenIdConnectRequest就没法正确解析请求里的表单参数，导致request.IsClientCredentialsGrantType()返回false，最后走到返回"unsupported_grant_type"的分支。

一定要确保在Startup的ConfigureServices中添加.AddMvcBinders()，就像上面代码示例里那样。

3. 请求参数解析出现异常 #

你可以在Exchange方法开头加几行调试代码，看看实际接收到的grant_type参数是不是正确的：

[HttpPost("~/connect/token"), Produces("application/json")]
public async Task<IActionResult> Exchange(OpenIdConnectRequest request)
{
    // 新增调试输出，确认grant_type的值
    Debug.WriteLine($"收到的grant_type参数：{request.GrantType}");
    
    Debug.Assert(request.IsTokenRequest(), "The OpenIddict binder for ASP.NET Core MVC is not registered. " + 
        "Make sure services.AddOpenIddict().AddMvcBinders() is correctly called.");
    
    // 剩下的原有代码...
}

如果输出的grant_type不是client_credentials，那说明参数没被正确解析。这时候可以检查请求的Content-Type是不是application/x-www-form-urlencoded——虽然你用了FormUrlEncodedContent，它会自动设置这个头，但偶尔也会有意外，手动确认一下更稳妥。

4. OpenIddict版本与.NET Core 2.0不兼容 #

.NET Core 2.0对应的OpenIddict版本是1.x系列（2.x及以上版本是给.NET Core 3.0+用的），如果你的项目里装了过高版本的OpenIddict，很可能会出现兼容性问题，导致请求处理异常。

去检查你的NuGet包引用，确保OpenIddict.AspNetCore、OpenIddict.EntityFrameworkCore这些包的版本是1.x（比如1.0.x或者1.1.x）。

总结 #

优先排查前两个问题：OpenIddict是否启用了Client Credentials流，以及MVC绑定器是否正确注册——这两个是导致这个错误的最常见原因。如果这两步都没问题，再通过调试确认参数解析和版本兼容性的问题。

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