当前位置：首页 > 文章列表 > 数据库 > Redis > Redis HELLO 怎样查看服务器协议与认证返回值

Redis HELLO 怎样查看服务器协议与认证返回值

来源：17golang原创 2026-11-03 04:52:24 0浏览收藏

Redis 连接建立后，想确认服务端支持哪种 RESP 协议、当前连接属于哪个实例，或者想把认证和连接命名放进一次握手，应该看 HELLO。它不是只返回一个“连通”结果：Redis 官方文档说明，HELLO 可以切换 RESP2/RESP3，并返回版本、连接 ID、运行模式、角色和模块等属性。

官方地址：https://redis.io/docs/latest/commands/hello/

实用结论：普通探活继续用 PING；连接初始化或协议排障使用 HELLO 2、HELLO 3，需要认证时把 AUTH username password 放在同一条 HELLO 中。认证失败时连接不会切换到 RESP3，仍要按 RESP2 失败路径处理。

HELLO 负责什么：协议协商与连接初始化

Redis 6 及以后支持 RESP2 和 RESP3。新连接默认从 RESP2 开始，因此老客户端仍可工作；客户端明确发送 HELLO 3 后，才把当前连接切到 RESP3。HELLO 的时间复杂度是 O(1)，它更像“连接能力说明 + 协议握手”，而不是业务数据命令。

Redis HELLO 连接入口与 RESP2 RESP3 协议结果的静态结构说明图 — 图1：Redis HELLO 握手结构说明图，查看协议选择、认证和连接属性的静态关系。

它和 PING 的分工可以这样记：

命令	主要用途	能得到什么
`PING`	连通性探活	简单的 PONG 或消息回显
`HELLO`	连接初始化与能力确认	协议版本、服务器属性、可选认证和连接名

用 redis-cli 读取协议和认证返回值

下面的命令只使用占位密码，适合先看命令形态。没有认证要求时，直接查询当前连接上下文；指定协议版本时，命令会同时协商协议。

# 查看当前连接的协议和服务器属性，不切换协议
redis-cli -h 127.0.0.1 -p 6379 HELLO

# 明确保持 RESP2，便于兼容旧客户端的返回处理
redis-cli -h 127.0.0.1 -p 6379 HELLO 2

# 请求 RESP3；连接名用于在连接列表中识别该客户端
redis-cli -h 127.0.0.1 -p 6379 HELLO 3 SETNAME article-reader

# 在新连接初始化时同时协商 RESP3 并认证；密码仅为示例占位符
redis-cli -h 127.0.0.1 -p 6379 HELLO 3 AUTH default 'YOUR_PASSWORD'

AUTH 只能跟在协议版本后面；SETNAME 等价于给当前连接设置名称。若服务端使用 Redis 6 以前的版本，可能返回未知命令；若协议版本不存在，则会返回协议错误。命令输出不要当成固定字段顺序，RESP2 和 RESP3 的呈现方式不同，客户端应按字段读取。

返回值怎样读：字段与失败状态

成功返回通常包含以下信息。server 表示服务端类型，version 是版本，proto 是当前协议；RESP3 还会返回 id、mode、role 和 modules 等连接或实例属性。

Redis HELLO 返回字段与协议认证失败边界的静态结构说明图 — 图2：Redis HELLO 返回字段结构说明图，查看属性字段与失败状态的边界。

# 只筛选返回中常用的协议、版本和角色字段，避免把整段输出写入日志
# 说明：示例使用文本过滤，生产程序应使用客户端库的结构化响应
redis-cli -h 127.0.0.1 -p 6379 --raw HELLO 3 | grep -E '^(server|version|proto|id|mode|role|modules)$'

这个过滤示例的目的只是帮助快速定位字段，不代表所有版本都按同样顺序输出。更稳妥的程序逻辑是：先判断命令是否成功，再读取 proto；把 server、version 作为诊断信息，把 id、mode、role 作为连接上下文。