主从同步失败大概率是版本不兼容导致协议握手失败，而非网络问题；需比对主从大版本号、检查psync2支持、确认masterauth配置及repl-backlog-size适配性。
从库 INFO replication 显示 master_link_status:down 但网络通怎么办
这大概率不是网络问题，而是主从协议握手失败。Redis 哨兵只管“谁当主”，不校验主从版本兼容性；一旦从库版本太低（比如 5.0 连 7.0 主库），PSYNC2 协议直接被拒，日志里可能只有模糊的 Connection reset by peer，根本不会提“版本不匹配”。
实操建议：
- 在从库上执行
redis-cli -v和主库比对，重点看大版本号是否一致（如Redis server v=7.0.15vsv=6.2.13） - 检查主库日志，搜索
Client protocol error或ERR wrong number of arguments—— 这类错误常出现在低版本从库尝试解析高版本 RDB 头部或 REPLCONF 指令时 - 临时停掉哨兵，手动用
SLAVEOF <master-ip><master-port></master-port></master-ip>测试直连，能快速排除哨兵干扰
Redis 6 和 7 的 repl-backlog-size 兼容性陷阱
Redis 7 默认启用 replica-serve-stale-data yes 和更激进的 backlog 管理策略，而 6.x 从库若收到主库发来的 REPLCONF capa psync2 后又遇到不识别的 capa 扩展（如 eof、ping），会静默断连，不报错也不重试。
实操建议：
- 主库为 7.x 时，从库必须 ≥ 6.2（最低支持 PSYNC2 完整能力），5.0/4.0 从库绝对不可用
- 在从库配置中显式加
replica-serve-stale-data yes，避免因主库启用了新特性（如replica-ignore-disk-write-errors）导致从库拒绝同步 - 主库
repl-backlog-size设得过大（如 1G），而从库内存不足或版本老（≤ 5.0），会因无法解析新格式的 backlog 元数据而卡在loading状态
哨兵日志里没报错，但从库始终 slave_priority 0 不参与选举
这不是同步问题，但会掩盖真实原因：slave_priority 0 表示该从库主动放弃被提拔资格，常见于配置了 slave-read-only yes 但未同步完成的旧版 Redis（如 4.0），它会在同步中途把 priority 写死为 0，且哨兵不会覆盖。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
实操建议：
- 查从库配置文件或运行时配置：
redis-cli CONFIG GET slave-priority，确认是否被人为设为 0 - 如果从库是 5.0+，检查是否有
replica-announced-ip或replica-announced-port配置错误，导致哨兵认为它不可达，从而跳过健康检查 - 重启从库前先
CONFIG SET replica-serve-stale-data yes，否则某些版本（如 6.0.16）会在启动时强制将 priority 归零
SYNC 变成 PSYNC 失败后降级逻辑失效的典型表现
旧版 Redis（≤ 4.0）从库连接新主库时，先发 PSYNC ? -1，主库若不认这个命令（比如开了 requirepass 但没配认证），会回 -NOAUTH Authentication required，但从库不处理这个错误，直接卡住——它不会退回到 SYNC，也不会重试，master_link_status 就一直显示 down。
实操建议：
- 主库开启密码认证时，从库配置必须有
masterauth <password></password>，且不能只靠CONFIG SET masterauth临时设置（部分旧版本不生效） - 用
redis-cli -h <slave> -p <port> --no-auth-warning INFO replication</port></slave>查看实时状态，注意master_last_io_seconds_ago是否持续增长（> 60 秒基本已卡死） - 别依赖
redis-server --version判断兼容性，有些发行版打包的 Redis 6.2 实际内核是 6.0.9，协议支持不全，要以redis-cli INFO server | grep redis_version为准
版本兼容不是“能连上就行”，Redis 主从同步在 5.0 之后引入了多轮能力协商、RDB v9 格式、partial resync 增强等机制，任意一环不匹配都会让同步静默失败。最稳妥的做法：主从大版本号严格一致，小版本尽量接近，别指望哨兵帮你兜底。
