树莓派上C#/.NET Core调用API报SocketException资源暂时不可用问题

错误根因 #

该SocketException: Resource temporarily unavailable异常核心触发原因是TCP临时端口耗尽：高频HTTP请求场景下套接字资源未正确复用，大量TIME_WAIT状态的连接堆积占满树莓派可用临时端口，叠加4G网络链路不稳定、连接建立延迟高的影响触发报错。
你无法捕获异常的原因是异步方法抛出的异常未被观测：未await的异步任务抛出异常时会直接抛到线程池，默认会触发进程终止。

解决方案 #

• 全局单例复用HttpClient：禁止每次发送请求都新建HttpClient实例，单例HttpClient会自动管理连接池，大幅减少套接字创建开销。
• 显式配置连接池参数：使用SocketsHttpHandler调整连接复用策略，适配4G不稳定的网络环境：

// 全局仅初始化一次
var socketsHandler = new SocketsHttpHandler
{
    // 连接最长生命周期，到期自动重建避免连接失效
    PooledConnectionLifetime = TimeSpan.FromMinutes(2),
    // 空闲连接超时回收
    PooledConnectionIdleTimeout = TimeSpan.FromSeconds(30),
    // 单域名最大并发连接数，根据实际请求频率调整
    MaxConnectionsPerServer = 10
};
HttpClient globalHttpClient = new HttpClient(socketsHandler);

• 完善异常捕获逻辑：所有调用SendHttpPost的位置必须添加await关键字，外层套try-catch块捕获相关异常；同时添加全局兜底异常处理避免进程直接退出：

// 进程启动时注册一次即可
AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
{
    // 此处添加异常日志记录逻辑
};
TaskScheduler.UnobservedTaskException += (sender, e) =>
{
    // 标记异常已被观测，阻止进程终止
    e.SetObserved();
    // 此处添加异常日志记录逻辑
};

• 优化树莓派系统TCP参数：编辑/etc/sysctl.conf文件添加如下配置，执行sysctl -p生效：

# 缩短TIME_WAIT状态连接回收时间
net.ipv4.tcp_fin_timeout = 15
# 扩大临时端口范围
net.ipv4.ip_local_port_range = 1024 65535
# 允许TIME_WAIT状态的套接字复用给新连接
net.ipv4.tcp_tw_reuse = 1

• 排查服务端链路限制：确认4G网关无并发连接数限制，反向代理、NodeJS服务端无高频请求封禁、短连接强制断开的相关配置。

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