.NET使用OAuth2客户端凭证模式获取令牌时遇错误求助

错误原因 #

你碰到的Cannot send a content-body with this verb-type错误，根源是代码的参数传递方式和请求头不匹配：你设置了content-type: application/json，但用AddParameter添加的参数默认被放到了URL的查询字符串里，没有在请求体中传入JSON格式的内容，RestSharp因此报错。

正确实现（两种常见格式） #

情况1：API要求application/x-www-form-urlencoded格式（多数标准OAuth2服务用这个） #

这是OAuth2客户端凭证模式的标准传递方式，参数放在请求体，格式为表单编码：

Dim Url As String = "https://api.site.com:21443/api/auth"
Dim client_id As String = "ID"
Dim client_secret As String = "SECRET"

' 初始化RestClient和POST请求
Dim rClient As New RestClient(Url)
Dim rRequest As New RestRequest(Method.Post)

' 设置表单编码的请求头
rRequest.AddHeader("content-type", "application/x-www-form-urlencoded")

' 添加参数到请求体（form-urlencoded模式下AddParameter默认放入请求体）
rRequest.AddParameter("client_id", client_id)
rRequest.AddParameter("client_secret", client_secret)
rRequest.AddParameter("grant_type", "client_credentials")

' 强制使用TLS1.2，避免安全协议不兼容
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12

' 执行请求并获取响应
Dim tResponse As RestResponse = rClient.Execute(rRequest)
Dim responseJson As String = tResponse.Content

情况2：API要求application/json格式 #

如果API明确要求用JSON格式传参，需要把参数打包成JSON字符串放到请求体：

Dim Url As String = "https://api.site.com:21443/api/auth"
Dim client_id As String = "ID"
Dim client_secret As String = "SECRET"

Dim rClient As New RestClient(Url)
Dim rRequest As New RestRequest(Method.Post)

' 设置JSON请求头
rRequest.AddHeader("content-type", "application/json")

' 构造JSON格式的参数对象
Dim requestBody As New With {
    .client_id = client_id,
    .client_secret = client_secret,
    .grant_type = "client_credentials"
}
' 将对象序列化为JSON并添加到请求体
rRequest.AddJsonBody(requestBody)

ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12

Dim tResponse As RestResponse = rClient.Execute(rRequest)
Dim responseJson As String = tResponse.Content

核心逻辑解释（针对新手） #

• 客户端凭证模式本质：用你的client_id和client_secret作为服务身份凭证，直接向授权服务器请求令牌，无需用户参与，适合服务间的后台调用。
• RestSharp组件作用：RestClient负责管理目标API的连接，RestRequest定义请求的方法、头信息、参数等核心内容。
• 请求头与参数的匹配：请求头必须和实际参数的传递格式一致，服务器才能正确解析参数，否则会出现解析失败或工具报错。
• 参数放置规则：
  • 表单编码格式：参数以键值对形式放在请求体，是OAuth2协议的标准做法。
  • JSON格式：需要将参数对象序列化为JSON字符串，通过AddJsonBody方法放入请求体，不能用普通的AddParameter。
• TLS1.2设置：强制使用高版本安全传输协议，避免因协议版本过低被服务器拒绝连接。

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