如何使用.NET Framework连接SAP Business One Service Layer并解决500报错

核心错误原因 #

该报错是.NET Framework与.NET Core的默认行为差异导致，和SAP Service Layer本身无关，两个最常见触发500错误的原因如下：

• 编码差异：.NET Framework中Encoding.Default为当前操作系统默认编码（中文环境通常为GB2312/GBK），而.NET Core+中Encoding.Default默认统一为UTF-8，SAP Service Layer仅支持UTF-8编码的请求体，编码不匹配会导致服务端解析失败抛出500错误。
• TLS版本默认配置差异：.NET Framework默认未启用TLS 1.2/1.3，而当前SAP Service Layer普遍禁用了低版本TLS协议，握手失败也会触发服务端返回500错误。

修正后的代码 #

// 全局只需要初始化一次，不要每次请求都new HttpClient
private static readonly HttpClient _client = new HttpClient();

// 程序启动时配置一次TLS版本，注意放在首次发起请求之前
ServicePointManager.SecurityProtocol |= SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;

// 登陆请求逻辑
string json = JsonConvert.SerializeObject(new 
{
    CompanyDB = "company",
    UserName = "username",
    Password = "password"
});
// 替换Encoding.Default为Encoding.UTF8
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await _client.PostAsync("service layer URL", content);

OData调用额外说明 #

不需要强制添加WCF服务引用，直接用HttpClient调用即可满足需求：

• 如果需要强类型解析OData返回结果，可以安装对应版本的OData客户端库，OData V3对应Microsoft.Data.OData包，V4对应Microsoft.OData.Core包
• 可选添加OData版本请求头避免格式兼容问题，例如V4版本可在请求头添加Accept: application/json;odata.metadata=minimal

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