Table of Contents

传输配置与调参

分册导航:net.md | net-topology.md | net-transport.md | [net-raft.md](raft 接入) | net-identity-security.md | net-p2p.md | net-observability.md | 运行拓扑与一致性 | 传输配置与调参 | raft 共识接入 | 身份与安全档 | P2P 会员与 gossip 广播 | 可观测与故障注入

5. 传输配置与调参

装配器方法覆盖常用项;全部运行参数经 WithTransport 调整,两种形态:

// 整份注入:自带一份配置(显式方法未触达的项以注入值为准)
var options = TransportOptions.Default(null, peers)
    .WithHandshakeTimeout(TimeSpan.FromSeconds(5));
await using var a = await ClusterBuilder.Create(nodeId)
    .WithTransport(options)
    .Listen("0.0.0.0", 9400)                 // 显式方法仍裁决对应项
    .StartAsync(ct);

// 管道改写:在装配结果上叠加(可多次调用,链尾依次执行——最终裁决)
await using var b = await ClusterBuilder.Create(nodeId)
    .Listen("0.0.0.0", 9400)
    .WithTransport(o => o.WithReconnect(
        TimeSpan.FromMilliseconds(100), 2.0, TimeSpan.FromSeconds(1)))
    .WithTransport(o => o.WithKeepalive(true))
    .StartAsync(ct);

裁决顺序:显式方法(Listen/Peers/ClusterTag/WithUdp)> WithTransport 注入 > 缺省表;管道链尾执行 = 最终裁决(可覆盖前述全部——ConfigureTransport 语义)。 NetClientBuilder 同款(客户端拨入带标签集群记得 ClusterTag)。

5.1 常用调参示例

// 重连退避:raft 场景封顶建议 < 选举窗一半——选举节奏不被重连劫持
o => o.WithReconnect(initialDelay: TimeSpan.FromMilliseconds(100), backoffFactor: 2.0, maxDelay: TimeSpan.FromSeconds(1))

// 传输级保活(NAT/防火墙长连接;双方都开才生效)
o => o.WithKeepalive(enable: true, interval: TimeSpan.FromSeconds(10), maxUnanswered: 3)

// 请求回调:高并发在途 / 大响应去重预算
o => o.WithRequest(timeout: TimeSpan.FromSeconds(3), pendingCapacity: 8192,
                   dedupCapacity: 4096, dedupMaxBytes: 32 << 20)

5.2 旋钮速查表

你要调 旋钮(缺省) 什么时候动它
握手超时 HandshakeTimeout(3s) 跨地域高延迟链路放宽
重连节奏 ReconnectInitialDelay(100ms)/ ReconnectBackoffFactor(×2)/ ReconnectMaxDelay(2s) 与选举窗/业务重试节奏对齐
传输保活 EnableKeepalive(关)/ KeepaliveInterval(10s)/ KeepaliveMaxUnanswered(3) NAT/有状态防火墙环境
请求超时 RequestTimeout(3s;per-call RequestOptions 覆盖) 慢接口单独放宽走 per-call
请求在途上限 RequestPendingCapacity(4096,满抛 fail-fast) 高并发 RPC
at-least-once 重放窗口 RequestDedupCapacity(1024)/ RequestDedupMaxBytes(8MiB) 大响应 + 重试语义
流式背压窗口 StreamWindowFrames(16 帧) 大块吞吐 vs 内存占用
写队列深度 WriteQueueFrames(64 帧) 写突发削峰
UDP 单报预算 UdpMaxDatagramBytes(1200B) 适配链路 MTU
慢回调观测阈值 SlowDispatchThreshold(10ms) 调低抓慢 handler

5.3 UDP 数据报承载

builder.WithUdp(9401);        // 端点绑定 + 握手通告对端;port 0 = 动态端口
  • 数据报/请求回调可走 UDP 承载(尽力语义不变);单报预算缺省 1200B(不做 IP 分片 依赖)——超预算自动回落 TCP 承载,调用方无感。
  • 加密场景:UDP 认证标签仅 KeyPair 档(会话派生 32B 标签,无键=丢弃计数);mTLS 档 UDP 报文不带认证标签(明文数据报——机密性/完整性需求走 TCP/流式通道,无自动回落实现)。

5.4 生效配置观测

endpoint.Options        // 装配自证——全部裁决后的最终值(TransportOptions)

排查"配置没生效"先看这里(管道链尾执行结果即它)。