.NET 6/7升级至.NET 8后调用WCF NetTcp端点触发参数异常

问题背景 #

将项目从.NET 6/7升级至.NET 8后，使用NetTcp绑定调用WCF端点时触发如下异常：

The value of this argument must be positive. (Parameter 'size')
Actual value was 0.

调用栈指向SSL/TLS握手阶段的读取操作，核心原因是.NET 8对SslStream的优化或绑定配置变更导致传递了0大小的读取请求。

具体解决方案 #

1. 显式配置绑定缓冲区参数 #

.NET 8中NetTcp绑定的默认缓冲区设置可能存在兼容性问题，需显式指定正整数的缓冲区大小：

代码方式配置

var binding = new NetTcpBinding(SecurityMode.Transport);
// 设置合理的缓冲区大小，可根据业务调整
binding.ReceiveBufferSize = 65536;
binding.SendBufferSize = 65536;
// 可选：根据消息大小调整最大接收消息尺寸
binding.MaxReceivedMessageSize = 2147483647;

配置文件方式

在app.config或web.config中添加绑定配置：

<bindings>
  <netTcpBinding>
    <binding name="CustomNetTcpBinding"
             receiveBufferSize="65536"
             sendBufferSize="65536"
             maxReceivedMessageSize="2147483647">
      <security mode="Transport">
        <transport clientCredentialType="Windows" />
      </security>
    </binding>
  </netTcpBinding>
</bindings>

2. 禁用TLS握手阶段的优化特性 #

.NET 8对SslStream的帧预读取优化可能导致异常，通过开关回退到旧版逻辑：

配置文件方式（appsettings.json）

{
  "AppContext.SetSwitch": {
    "System.Net.Security.SslStream.UseLegacyReceiveHandshakeFrame": true
  }
}

代码启动时设置

// 在应用启动初期设置（如Program.cs开头）
AppContext.SetSwitch("System.Net.Security.SslStream.UseLegacyReceiveHandshakeFrame", true);

3. 对齐客户端与服务端绑定配置 #

确保服务端的NetTcp绑定参数（缓冲区大小、安全模式、消息尺寸限制等）与客户端完全一致，避免因两端配置不匹配导致的握手失败。

4. 更新WCF相关NuGet包 #

确认项目中引用的System.ServiceModel.*系列包为.NET 8对应的最新稳定版本，修复官方已知的兼容性Bug。

验证方法 #

应用上述配置后，重启客户端与服务端，重新发起WCF调用，确认异常是否消失。

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