.NET6中OpenIddictRequest无法识别grant_type参数问题

• 核心根因优先排查：不要直接将OpenIddictRequest声明为Action参数走MVC默认模型绑定
  OpenIddict 3.x 未内置适配MVC默认模型绑定的逻辑，直接在Action方法签名中写async Task<IActionResult> Exchange(OpenIddictRequest openIdRequest)时，参数实例由MVC默认的表单/查询值提供器赋值，这套逻辑默认不识别OAuth2规范的下划线分隔参数名（如grant_type），只会匹配与C#属性名命名规则一致的参数（如Pascal格式的GrantType、小驼峰格式的grantType），和你观察到的现象完全吻合：
  • 仅传grant_type时，MVC绑定逻辑无法识别下划线参数名，不会给GrantType属性赋值，调试时看到参数少1个，openIdRequest.IsPasswordGrantType()返回false，但此时原始请求中存在grant_type，OpenIddict内置的必填参数校验直接读取原始请求表单，不会抛出参数缺失错误
  • 额外添加grantType=password参数时，MVC绑定逻辑识别该参数并给GrantType属性赋值，此时调试能看到4个参数，IsPasswordGrantType()返回true，同时原始请求中仍存在grant_type，满足OpenIddict的校验要求
  • 仅传grantType、删除grant_type参数时，MVC虽然能给GrantType属性赋值，但OpenIddict内置校验读取原始请求找不到标准参数grant_type，直接抛出openiddict the mandatory 'grant_type' parameter is missing错误
    修正方式：从Action参数列表中移除OpenIddictRequest参数，在方法内部通过HttpContext.GetOpenIddictRequest()获取官方封装的请求实例，该实例会自动正确识别所有OAuth2标准下划线命名参数。
• 检查Postman请求格式是否符合规范
  OAuth2令牌端点要求所有参数必须以application/x-www-form-urlencoded格式放在请求体中，以下错误传参方式会导致参数读取异常：
  • 将参数拼接在URL查询字符串中传递
  • 选择form-data格式传参
  • 选择raw/JSON格式传参
    传参时必须使用标准下划线命名的grant_type参数，不要传非标准的小驼峰grantType参数。
• 排查中间件/模型绑定的参数改写逻辑
  如果修正请求获取方式后仍存在异常，在Action入口处直接读取Request.Form.Keys查看原始表单集合：
  • 如果原始集合中不存在grant_type键，检查是否有自定义中间件、模型绑定提供器、值提供器对请求参数做了下划线转驼峰的改写，导致原始参数被过滤
  • 如果原始集合中存在grant_type键，但GetOpenIddictRequest()获取的实例中GrantType为空，检查OpenIddict服务端配置是否添加了错误的参数过滤规则。
• 检查授权流配置
  确认服务端配置中添加了.AllowPasswordFlow()显式启用密码授权模式，否则即使参数传递正确，密码流相关校验逻辑也不会正常执行。

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