遇到客户端端口耗尽，最优先的方案是在应用层启用连接池并保持长连接，其次才是调整操作系统的端口范围参数。
先说结论：端口耗尽通常是客户端短连接过多导致的，单纯调大系统端口范围只能延缓问题，根本解决需要配置客户端连接池。
- 适合场景：高并发写入或查询导致客户端机器出现大量 TIME_WAIT 连接
- 先准备：确认当前客户端使用的 HTTP 客户端库是否支持连接池配置
- 验收：观察客户端机器出站连接数是否稳定，不再持续增长
命令速用版
如果你需要临时缓解症状，可以在客户端机器上执行以下命令扩大临时端口范围并允许重用 TIME_WAIT 连接：
sysctl -w net.ipv4.ip_local_port_range="1024 65535" sysctl -w net.ipv4.tcp_tw_reuse=1
注意：这仅是止血措施，必须配合应用层连接池配置才能根治。
为什么会这样
Linux 系统作为 TCP 客户端发起连接时，会使用临时端口（Ephemeral Ports）。默认情况下，每个请求如果用完即断开，连接会进入 TIME_WAIT 状态，占用一个端口直到超时（通常 60 秒左右）。当并发请求速度超过端口释放速度时，可用端口会被耗尽，导致新的连接无法建立，报错通常为 "Cannot assign requested address"。
Elasticsearch 基于 HTTP 协议，如果客户端每次请求都新建 TCP 连接而不复用，极易触发此限制。服务器端的连接数限制通常较高，瓶颈多在客户端侧。
分步处理
1. 确认当前连接状态
在客户端机器上执行以下命令，查看是否有大量 TIME_WAIT 状态的连接指向 ES 端口（默认 9200）：
ss -ant | grep :9200 | grep TIME_WAIT | wc -l
如果数量持续居高不下或接近端口范围上限，说明存在连接泄露或未复用。
2. 配置客户端连接池（关键步骤）
根据你使用的编程语言和客户端库，启用 Keep-Alive 和连接池。核心原则是客户端对象单例化，避免每次请求都实例化新的客户端对象。
Java 客户端配置示例：
注意：Elasticsearch 8.x 起 High Level REST Client 已标记废弃，推荐使用新的 elasticsearch-java 客户端，但底层 RestClient 连接池配置逻辑相似。以下是基于 RestClientBuilder 的通用配置：
RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
// 最大连接总数，根据客户端机器网卡端口资源和并发量调整
builder.setMaxConnTotal(100);
// 每个路由的最大连接数，通常设为与总连接数一致以避免瓶颈
builder.setMaxConnPerRoute(100);
RestClient client = builder.build();
// 务必将 client 作为单例保持在应用中，不要每次请求都 build()参数说明：maxConnTotal 控制客户端能建立的最大并发连接数；maxConnPerRoute 控制对同一主机（ES 节点）的最大连接数。若 ES 是集群，需确保该值足够支撑并发。
Python 客户端配置示例：
官方 Python 客户端底层基于 urllib3，默认启用连接池。关键在于确保客户端实例全局复用：
from elasticsearch import Elasticsearch# 全局单例，避免每次请求实例化
es = Elasticsearch(["http://localhost:9200"],max_retries=3,retry_on_timeout=True,# 底层 urllib3 默认启用连接池，无需额外配置即可复用
)# 业务代码中直接调用 es.search() 等，不要重复创建 es 对象3. 调整操作系统内核参数（辅助步骤）
如果业务确实需要极高并发且连接池已优化，可适当扩大端口范围。编辑 /etc/sysctl.conf 添加或修改：
net.ipv4.ip_local_port_range = 1024 65535 net.ipv4.tcp_tw_reuse = 1
执行 sysctl -p 生效。注意 tcp_tw_reuse 在 NAT 环境下需谨慎使用，但在客户端访问 ES 场景通常安全。
4. 检查服务端限制
确认 Elasticsearch 服务端的 network.max_http_connections 配置是否过小，虽然默认值通常足够，但在极端情况下也可能成为瓶颈。
怎么验证是否生效
执行以下命令监控连接状态变化：
watch -n 1 "ss -ant | grep :9200 | grep TIME_WAIT | wc -l"
配置生效后，TIME_WAIT 数量应维持在一个相对稳定的低位，不再随请求量线性增长。同时观察应用日志，确认不再出现 "Cannot assign requested address" 或连接超时错误。
常见坑
- 不要开启 tcp_tw_recycle：该参数在 NAT 环境下会导致连接失败，现代 Linux 内核已默认隐藏或废弃此选项。
- 只调系统参数不治本：如果不启用客户端连接池，仅扩大端口范围，端口迟早会再次耗尽，只是时间推迟。
- 客户端单例化：确保 HTTP 客户端对象在应用中是单例复用的，避免每次请求都 new 一个客户端实例。
- 防火墙干扰：某些中间网络设备可能会强制断开空闲长连接，需确认网络链路支持 Keep-Alive。
- 版本差异：ES 8.x Java 客户端 API 有变化，但连接池底层配置原理一致，注意查阅对应版本文档。
参考来源
- Elasticsearch Official Documentation, "Client Connections", https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html
- Linux Kernel Documentation, "TCP/IP Networking", https://www.kernel.org/doc/html/latest/networking/index.html
原文链接：https://www.zjcp.cc/ask/10849.html