Redis CLIENT SETINFO 怎么标记连接：LIB-NAME、LIB-VER 与排障核对

Redis 连接池出现慢请求时，`CLIENT LIST` 往往只能告诉你地址、用户名和连接状态，无法直接说明“这是哪个客户端库、哪一版 SDK”。Redis 7.2 增加的 `CLIENT SETINFO` 允许当前连接写入 `LIB-NAME` 和 `LIB-VER`，再通过连接诊断命令把来源标记带进排障现场。

初始化连接时，在认证成功后尝试发送 `CLIENT SETINFO LIB-NAME go-redis` 和 `CLIENT SETINFO LIB-VER 9.7.0`，随后用 `CLIENT LIST` 核对标记。旧 Redis 不认识该命令时应忽略失败并继续建连，不能因为诊断标签缺失而让业务连接启动失败。

为什么连接诊断需要应用侧标签

同一台 Redis 可能同时接收 Go、Java、Python 和任务脚本的请求。只看 `addr` 或 `user`，很难回答某个慢连接究竟来自哪套连接池。`CLIENT SETINFO` 写入的是当前连接属性，不改变 key 和命令语义，因此它适合做低成本的连接可观测性补充。

认证后设置两个稳定属性

最小命令只有两个变体。每次连接建立并完成认证后执行一次即可，重复设置会覆盖当前连接上的同名属性。

AUTH app-user app-password
CLIENT SETINFO LIB-NAME order-worker
CLIENT SETINFO LIB-VER 2026.08.21
CLIENT INFO

返回 `OK` 只说明当前连接接受了属性写入。不要把它当成全局配置，也不要期待新连接自动继承旧连接标签；连接池扩容、断线重连和故障转移都要重新执行初始化动作。

用 CLIENT LIST 找到混用版本的连接

管理连接执行 `CLIENT LIST` 可以查看在线连接。将返回结果中的 `lib-name`、`lib-ver` 与 `addr`、`age`、`idle`、`cmd` 一起记录，就能把“某类连接延迟升高”缩小到具体客户端来源。`CLIENT INFO` 则适合在客户端自己的连接上核对当前属性。

CLIENT LIST
# 关注：
# lib-name=order-worker lib-ver=2026.08.21
# addr、age、idle、cmd、user

CLIENT INFO

建议把连接标签和监控维度对齐，但不要把完整请求参数、用户隐私或长文本塞进属性值。标签的目的，是让现场人员快速完成来源分组，不是替代日志系统。

旧版本兼容要靠“可选能力”设计

`CLIENT SETINFO` 从 Redis 7.2.0 开始提供。连接初始化代码面对旧服务端时可能收到未知命令错误，这不应阻断业务连接。更稳妥的策略是：认证成功后发送标签命令；成功则记录已标记，失败则记录一次低频兼容日志，然后继续执行健康检查。

连接初始化：
1. 建立 TCP 连接并认证
2. 尝试 CLIENT SETINFO LIB-NAME
3. 尝试 CLIENT SETINFO LIB-VER
4. 忽略“命令不存在”类兼容失败
5. 用 PING 或业务健康检查确认连接可用

属性值不能包含空格、换行或其他不可打印字符。版本号、应用名和环境信息应使用短的 ASCII 标记，例如 `payment-api`、`8.1.4`、`staging`；环境字段若需要记录，建议通过应用名后缀组合，而不是写入无法稳定解析的自由文本。

上线前做四项核对

1. 新建连接：认证后能看到预期的 `lib-name` 和 `lib-ver`。
2. 重连恢复：主动断开后新连接仍会重新写入标记。
3. 旧服务端：不支持 `CLIENT SETINFO` 时业务连接仍能完成健康检查。
4. 排障查询：`CLIENT LIST` 的来源标签能和连接池监控、发布版本对应。

连接标签最好纳入版本发布验收：如果一批连接突然出现新的 `lib-ver`，值班人员可以直接判断是否存在灰度混用，而不用先翻所有应用日志。

常见问题

CLIENT SETINFO 会修改 Redis 数据吗？

不会。它只给当前连接写入展示在连接信息中的属性，不改变 key、value 或数据库内容。

CLIENT SETINFO 的属性会被 RESET 清掉吗？

官方文档说明这些属性不会被 `RESET` 清除，但新建连接仍需重新设置。

旧 Redis 不支持 CLIENT SETINFO 怎么办？

将其视为可选能力：记录兼容日志并继续连接初始化，不能让诊断标签影响业务可用性。

属性值能不能写中文或带空格？

不建议。为了保持 `CLIENT LIST` 格式可解析，应使用没有空格、换行和不可打印字符的短标记。

让连接来源成为可查询的现场证据

`CLIENT SETINFO` 的价值不在于多两个字段，而在于把客户端库和版本带到 Redis 的连接现场。认证后设置、重连时恢复、旧版本忽略失败，再用 `CLIENT LIST` 和 `CLIENT INFO` 验证，连接池排障就多了一条稳定的证据链。