Dynamics AX调用DPD接口Json反序列化报意外字符F错误排查

报错Newtonsoft.Json.JsonReaderException: Unexpected character encountered while parsing value: F. Path '', line 0, position 0的核心原因是：你传入反序列化方法的响应字符串不是合法JSON，字符串首字符为'F'，问题出在请求发送逻辑、接口返回内容不符合预期，和你定义的请求参数字段本身无关。

• 你当前用FormUrlEncodedContent发送的是application/x-www-form-urlencoded格式的表单请求，而DPD官方服务接口默认要求请求体为application/json格式，格式不匹配时接口会直接返回纯文本错误提示，最常见的就是首字母为F的Forbidden、Fault: invalid request这类内容，完全匹配报错特征。
• EnsureSuccessStatusCode()仅会对4xx/5xx状态码抛异常，无法校验返回内容格式，哪怕是200状态码，也可能因为网关、代理配置问题返回纯文本、HTML错误页而非JSON。
• 你用.Result同步阻塞异步方法的写法，在Dynamics AX的CLR托管环境下容易触发请求上下文死锁，导致拿到的响应不是接口真实返回的业务内容。

1. 先加日志打印原始响应内容，定位具体错误：

var responseMessage = httpClient.SendAsync(requestMessage).Result;
string rawResponse = responseMessage.Content.ReadAsStringAsync().Result;
// 此处先将rawResponse、responseMessage.StatusCode输出到日志或弹窗，就能看到完整的F开头错误文本
if (!responseMessage.IsSuccessStatusCode)
{
    throw new Exception($"DPD接口调用失败，状态码：{responseMessage.StatusCode}，返回：{rawResponse}");
}
// 确认返回内容是合法JSON后再执行反序列化
return JsonConvert.DeserializeObject<COIDpdResponse>(rawResponse);

2. 替换请求内容格式，按接口要求发送JSON：

// 删除原有FormUrlEncodedContent的赋值逻辑，替换为以下代码
string requestJson = JsonConvert.SerializeObject(request);
requestMessage.Content = new StringContent(requestJson, Encoding.UTF8, "application/json");

3. 修正实体类序列化规则：Endpoint字段是你本地用来存接口地址的，不需要传给DPD接口，给该字段加[JsonIgnore]标记，避免多余字段触发接口参数校验错误。
4. 确认DPD接口认证规则：大部分DPD pickup接口要求将账号密码通过Basic Auth放在请求头中，而非放在请求体里，参数传错位置会直接返回403 Forbidden，和报错首字符F的特征完全吻合。

不要在Dynamics AX自定义开发中用.Result阻塞异步方法，可直接使用HttpClient.Send()同步方法发送请求，避免上下文死锁导致的异常。

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