讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决Redis集群中"Address already in use"报错_检查端口占用情况与TIME_WAIT连接

云丽小哥_1799

云丽小哥_1799

发布时间:2026-06-19 09:04:07

|

334人浏览过

|

来源于php中文网

原创

Redis集群节点启动报“Address already in use”,绝大多数因端口被占或TIME_WAIT耗尽本地端口池;须用ss -tuln查6379/16379监听状态,再结合sudo lsof -iTCP:6379 -sTCP:LISTEN精准定位占位进程,并检查net.ipv4.tcp_tw_reuse等内核参数是否适配集群双向通信需求。

如何解决redis集群中\

Redis 集群节点启动失败并报 Address already in use,绝大多数情况不是配置写错,而是端口被占或内核未释放——必须分两层查:先看有没有进程真正在 listen,再看有没有大量 TIME_WAIT 卡住本地端口池。

怎么快速确认是哪个进程在监听 6379(或集群其他端口)

别直接 kill 或改配置,先定位“占位者”。Redis 集群默认每个节点用一个主端口(如 6379)加一个集群总线端口(16379),两者都可能被占。

  • 用 ss -tuln | grep ':6379\|:16379' 查监听状态,输出里带 LISTEN 且地址含 *:6379 或 *:16379 的行就是目标
  • 若看到 PID/进程名(如 redis-server),再执行 ps -p <PID> -o pid,ppid,cmd 确认是不是你本该停掉的旧实例
  • 若没显示进程名(比如只显示 -),说明权限不足,加 sudo 重试;或者用 sudo lsof -iTCP:6379 -sTCP:LISTEN 更准
  • 特别注意 Docker 容器:docker ps --format "table {{.ID}}\t{{.Ports}}" | grep '6379' 可能暴露桥接映射

为什么杀完进程还是报 Address already in use

常见于频繁启停集群节点的开发环境,本质是内核处于 TIME_WAIT 状态,不是进程没杀干净。

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载
  • ss -tan state time-wait | grep ':6379' 能筛出连到本机 6379 的客户端连接残留(比如别的节点连它失败后留下的)
  • 但更关键的是看**本地发起的连接**:集群节点间通信(如 CLUSTER MEET)会主动 connect 其他节点,这些 outbound 连接关闭后进入 TIME_WAIT,会占用本地临时端口,不是 6379 本身,但可能耗尽 ip_local_port_range
  • 运行 ss -s,重点看 time-wait 行数字。如果远超 established(例如 2w vs 50),且 net.ipv4.ip_local_port_range 是默认 32768 65535,就说明本地端口池快满了
  • 此时即使 6379 没被 listen,bind() 仍可能失败——因为内核分配不出可用源端口给新连接(集群握手、Gossip 等都需要)

Redis 集群场景下该调哪些内核参数

单机 Redis 可能只需杀进程,但集群节点既是服务端又是客户端,必须同时处理两端的端口压力。

  • 必须开启 net.ipv4.tcp_tw_reuse = 1:允许把 TIME_WAIT 状态的 socket 用于新的 outbound 连接(对集群节点间通信至关重要)
  • 必须设 net.ipv4.tcp_fin_timeout = 30:缩短 FIN_WAIT_2 超时,加快连接清理(比默认 60 秒更激进但安全)
  • 建议扩端口范围:net.ipv4.ip_local_port_range = 1024 65535(避开 1–1023 权限限制,实际可用端口翻倍)
  • 禁用已废弃的 net.ipv4.tcp_tw_recycle = 0(NAT 环境下会导致连接失败,K8s 或云厂商 SLB 下必关)
  • 以上修改后需 sysctl -p 生效,且要写入 /etc/sysctl.conf 防重启丢失

集群配置里容易忽略的 bind 地址陷阱

报错里常出现 *:6379,但实际绑定失败可能是因为 bind 配置不匹配网卡。

  • 检查 redis.conf 中 bind 行:若写成 bind 127.0.0.1,而集群节点间用的是局域网 IP(如 192.168.1.10),则其他节点 connect 失败后反复重试,会堆积 TIME_WAIT
  • 集群模式下推荐显式绑定多地址:bind 127.0.0.1 192.168.1.10,或干脆注释掉 bind(依赖 protected-mode no + 密码控制)
  • cluster-announce-ip 和 cluster-announce-port 必须与真实对外地址一致,否则其他节点解析到错误 IP,连接持续失败 → 大量 TIME_WAIT
  • 容器部署时,host.docker.internal 或 network_mode: host 配置错误,也会导致节点互相 resolve 到 127.0.0.1,形成无效环路连接

真正麻烦的不是 Address already in use 本身,而是它背后混着两类问题:一个是别人正用着那个端口,另一个是你自己发出去的连接太多太碎,把本地端口池堵死了。集群节点双重身份决定了必须两边一起看,漏掉任何一层,都会反复踩坑。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4329

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3835

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

6972

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

623

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

756

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

6642

2024.04.07

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1160

2024.04.07

redis的8种数据类型有哪些
redis的8种数据类型有哪些

redis 提供 8 种数据类型:字符串(文本、数字、二进制)、哈希(键值对)、列表(有序集合)、集合(无序唯一元素)、有序集合(按分数排序)、地理空间(地理位置)、hyperloglog(估计大数据基数)和位图(位序列存储)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1036

2024.04.07

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn