Redis SMOVE 返回 0 时怎么判断源集合状态

Redis 的 SMOVE 返回 0 时，优先判断源集合中是否存在指定成员，而不是先把它当成连接失败。这个返回值表示 Redis 没有找到可移动的成员，因此没有执行移动；如果源键或目标键的类型不正确，通常会进入错误分支。

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

SMOVE source destination member 成功移动返回 1；源集合中找不到成员时返回 0，并且不会执行移动。类型错误等异常则通过 error 返回。

先把 SMOVE 的返回值和错误值分开

SMOVE 只处理一个成员：它先在 source 集合里查找 member，找到后从源集合移除，再把成员加入 destination。因此结果只有两个正常分支：

这里的关键是把“正常但没有命中”和“命令执行失败”分开。应用层可以把返回 0 记录为一次未发生的迁移，把 error 交给重试、告警或错误处理逻辑。

为什么源集合找不到成员时会返回 0

当成员不存在时，Redis 不会为了创建目标集合而强行写入，也不会返回一个代表“目标集合创建失败”的特殊数字。源集合是移动动作的前提，前提不成立，整次 SMOVE 就保持不变并返回 0。

源键不存在时，可以把它理解为没有可供查找的集合内容，结果同样是 0。这也是为什么不应该仅凭返回值断言“Redis 服务不可用”：服务正常时，空源集合也会产生这个合法结果。

用 redis-cli 观察成功移动和返回 0

下面的命令分别准备一个存在成员和一个不存在成员。命令中的注释说明每一步目的；输出中的整数是 Redis 对本次动作的结果。

# 准备源集合，alice 是可移动成员
redis-cli SADD queue:waiting alice bob

# alice 存在，移动成功时返回 1
redis-cli SMOVE queue:waiting queue:running alice

# carol 不在源集合中，未执行移动时返回 0
redis-cli SMOVE queue:waiting queue:running carol

# 分别查看源集合和目标集合，确认只有 alice 被移动
redis-cli SMEMBERS queue:waiting
redis-cli SMEMBERS queue:running

第一次 SMOVE 的返回值代表实际发生了一次移动；第二次返回 0，表示 carol 没有在当时的源集合里。最后两条读取命令只是观察状态，不应被当成 SMOVE 的返回值。

Go 客户端怎样区分 0 和 error

以 github.com/redis/go-redis/v9 为例，客户端方法会同时返回命令结果和错误值。判断顺序应该是先看 err，再解释结果；否则很容易把“没有成员可移动”误报成调用失败。

package main

import (
	"context"
	"fmt"

	"github.com/redis/go-redis/v9"
)

// moveMember 只把一个成员从源 Set 移到目标 Set，并保留 Redis 的结果语义。
func moveMember(ctx context.Context, client *redis.Client, source, destination, member string) (bool, error) {
	moved, err := client.SMove(ctx, source, destination, member).Result()
	if err != nil {
		// 类型错误、连接中断等情况不能降级成“返回 0”。
		return false, fmt.Errorf("执行 SMOVE 失败: %w", err)
	}

	// moved=false 表示命令成功但源集合没有该成员，未执行移动。
	return moved, nil
}

func main() {
	ctx := context.Background()
	client := redis.NewClient(&redis.Options{Addr: "localhost:6379"})
	defer client.Close() // 释放客户端资源；生产服务应复用长生命周期客户端。

	moved, err := moveMember(ctx, client, "queue:waiting", "queue:running", "carol")
	if err != nil {
		fmt.Println(err)
		return
	}
	if !moved {
		fmt.Println("源集合没有该成员，本次未移动")
		return
	}
	fmt.Println("成员已移动")
}

这里的 moved 是布尔结果：true 对应 Redis 返回 1，false 对应 Redis 返回 0。它只有在 err == nil 时才有正常业务含义。

目标集合变化时，成功条件并没有改变

目标集合不存在时，成功移动通常会让 Redis 创建目标集合并放入成员；目标集合已经存在时，成员则被加入现有集合。无论是哪一种情况，成功条件始终是“源集合里找到了这个成员”。

反过来，如果源集合没有成员，即使目标集合已经存在、目标集合刚刚被其他请求修改过，当前这次 SMOVE 仍然返回 0。不要用目标集合的大小变化来替代命令返回值，也不要把目标集合为空误判为移动失败。

如果业务要求“只有在某个版本或状态满足时才移动”，应把这个条件设计到更完整的事务或服务流程中；单独的 SMOVE 只对源集合成员是否存在负责。

旧判断逻辑应该怎样改

常见的旧代码会把 moved == false 和网络错误放进同一条失败路径。这样会导致两个问题：正常的重复消费或幂等调用被当作系统故障，真正的类型错误又缺少清晰的原因。

如果未移动是可预期的幂等结果，可以记录低级别业务日志；如果 err 非空，再根据错误类型决定是否重试。两者不要共用一个没有上下文的“迁移失败”计数器。

最小核对清单

1. 源集合存在成员时，SMOVE 返回 1，成员从源集合进入目标集合。
2. 源集合不存在或没有指定成员时，返回 0，没有执行移动。
3. 源键或目标键类型不正确时，优先读取并处理 error。
4. Go 客户端先判断 err，再解释布尔结果；不要用目标集合状态替代返回值。

常见问题

SMOVE 返回 0 是不是 Redis 连接失败？

不一定。连接或命令执行失败通常会通过错误值体现；返回 0 可能只是源集合中没有指定成员。

目标集合不存在会让 SMOVE 返回 0 吗？

目标集合不存在本身不是失败条件。只要源集合里有成员，Redis 可以在成功移动时创建目标集合；是否返回 1 取决于源集合是否命中成员。

是否应该先 EXISTS 检查源键？

通常不需要。直接执行 SMOVE 就能得到移动结果；额外的 EXISTS 还可能与随后动作之间产生竞态，也不能替代错误处理。

返回 0 后要不要重试？

如果 0 表示成员已经被其他消费者移动或本来就不存在，它是正常的幂等结果，不应仅凭这个数字重试。只有出现明确的命令错误，才根据错误类型决定重试策略。

记住一句话：SMOVE 返回 0 的重点是“源集合没有可移动的成员”，而不是“Redis 没有工作”。先分开结果值和错误值，再决定记录、重试或告警，迁移逻辑会稳定得多。