ASP.NET Core调用内部API发POST请求报500错误但Postman正常如何解决

触发原因 #

• 序列化输出的JSON与Postman发送的结构不一致：Newtonsoft.Json默认的日期序列化规则、字段命名策略可能和Postman的请求体不符，尤其是LoginDate字段的时区偏移格式、字段名大小写/拼写问题，会导致服务器解析参数失败返回500。
• UTF8编码携带BOM头：代码中new UTF8Encoding()默认生成带BOM的UTF8字节流，部分API服务器无法解析JSON开头的BOM标记，而Postman发送的是无BOM的UTF8内容。
• 自定义User-Agent触发服务端拦截：代码中设置的IE6时代的UA过于陈旧，部分内部服务会拦截异常UA请求，Postman使用的标准UA不会触发拦截。
• HttpWebRequest兼容问题：该类属于.NET Framework遗留API，在.NET Core中存在连接管理、协议处理的兼容缺陷，官方已不推荐使用。

修复方案 #

推荐方案（使用.NET Core官方推荐的HttpClient） #

HttpClient是.NET Core/.NET 5+官方指定的HTTP请求类，原生处理编码、头信息等规范问题，无需手动处理字节流和连接生命周期。
注意：HttpClient建议通过依赖注入注册单例使用，避免每次请求新建实例导致的端口耗尽问题。

// 配置序列化规则，保证输出与Postman请求体完全一致
var jsonSerializeSettings = new JsonSerializerSettings
{
    DateFormatHandling = DateFormatHandling.IsoDateFormat,
    DateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind, // 保留日期的时区偏移信息
    ContractResolver = new Newtonsoft.Json.Serialization.DefaultContractResolver
    {
        // 禁用自动驼峰转换，保证字段名与实体类属性名、Postman请求字段完全匹配
        NamingStrategy = null
    }
};
string requestJson = JsonConvert.SerializeObject(listOfMem, jsonSerializeSettings);

// 若通过依赖注入获取HttpClient实例请替换此行
using var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));
// 如无特殊要求可删除自定义UA配置，使用HttpClient默认UA即可
// httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");

var requestContent = new StringContent(requestJson, System.Text.Encoding.UTF8, "application/json");
var response = await httpClient.PostAsync(url, requestContent);
// 调试阶段可先打印响应状态码和错误内容，快速定位问题
if (!response.IsSuccessStatusCode)
{
    var errorContent = await response.Content.ReadAsStringAsync();
    // 此处可打印errorContent查看服务端返回的具体错误信息
}
response.EnsureSuccessStatusCode();
string result = await response.Content.ReadAsStringAsync();

兼容原代码的修改方案 #

如果需要保留HttpWebRequest的写法，只需修改两个核心点即可：

1. 序列化时添加上述序列化配置，保证输出JSON与Postman一致
2. 改用无BOM的UTF8编码
   修改后的核心代码片段：

// 新增序列化配置
var jsonSerializeSettings = new JsonSerializerSettings
{
    DateFormatHandling = DateFormatHandling.IsoDateFormat,
    DateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind,
    ContractResolver = new Newtonsoft.Json.Serialization.DefaultContractResolver
    {
        NamingStrategy = null
    }
};
String json = Newtonsoft.Json.JsonConvert.SerializeObject(listOfMem, jsonSerializeSettings);
// 构造函数传false表示不生成BOM头
UTF8Encoding encoding = new UTF8Encoding(false);
Byte[] bytes = encoding.GetBytes(json);
// 其余原代码保持不变即可

排查技巧 #

调试时可将序列化生成的json字符串与Postman的请求体做逐字符对比，若存在差异优先调整序列化参数，即可快速定位问题。

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