在使用Redis有序集合（Sorted Set）存储带时间戳或评分的数据时，经常遇到一个需求：把某个分数范围内的元素批量清理掉。比如活跃用户列表里剔除一个月未登录的用户，或者排行榜里清掉低分用户。直接遍历删除效率太低，Redis提供的ZREMRANGEBYSCORE命令就是为这类场景设计的，它可以按分数区间一次性删除多个成员，本文详细介绍它的用法和注意事项。
一、ZREMRANGEBYSCORE的基本语法与执行逻辑
ZREMRANGEBYSCORE的完整语法是：ZREMRANGEBYSCORE key min max。其中key是有序集合的键名，min和max定义了分数区间，命令会删除所有分数在这个区间内的成员，返回值是被删除成员的数量。如果key不存在，返回0。
这里有个容易混淆的地方要说明一下：虽然命令名字里带RANGE，但它和ZRANGE的查看语义不同，它是一个写操作，执行后数据就真的没了，不可回滚。所以在生产环境执行前，建议先用ZCOUNT key min max统计一下区间内有多少元素，确认数量符合预期再执行删除。
min和max默认是闭区间，也就是包含端点值。如果想使用开区间，需要在参数前加上英文圆括号，例如：
ZADD ranking 80 alice 90 bob 60 carol 95 david # 删除分数在60到80之间（包含60和80）的成员 ZREMRANGEBYSCORE ranking 60 80 # 返回2，alice和carol被删除 # 删除分数小于90（不包含90）的成员，用-inf表示负无穷 ZREMRANGEBYSCORE ranking -inf (90 # 返回1，bob被删除
除了-inf表示负无穷，还可以用+inf表示正无穷，配合区间写法可以灵活表达各种边界条件。比如ZREMRANGEBYSCORE ranking (80 +inf表示删除所有分数大于80的成员。这种无限值符号在按时间戳清理旧数据的场景里特别常用，因为不必提前知道最小的时间戳是多少。
二、按时间区间清理数据的实战示例
有序集合最常见的用法之一是把时间戳当作score，成员是业务ID，比如记录用户的操作日志。假设member是日志ID，score是记录时间（毫秒时间戳），现在要清理7天前的所有日志，可以这样写：
import redis
import time
client = redis.Redis(host='127.0.0.1', port=6379, decode_responses=True)
now_ms = int(time.time() * 1000)
seven_days_ago = now_ms - 7 * 24 * 3600 * 1000
# 先统计将被删除的数量，避免误删
count = client.zcount('user:logs', '-inf', seven_days_ago)
print(f'待删除日志数: {count}')
# 删除7天前的所有日志，-inf表示从最小分数开始
deleted = client.zremrangebyscore('user:logs', '-inf', seven_days_ago)
print(f'实际删除日志数: {deleted}')上面的代码先调用zcount做预检，这是生产环境的好习惯。python的redis客户端会自动把整型参数转成字符串发给Redis服务端，区间边界和上面命令行的写法一致。
再举一个Go语言的例子，场景是清理不活跃用户。用score记录用户最后活跃时间，每天定时任务执行一次：
package main
import (
"context"
"fmt"
"time"
"github.com/go-redis/redis/v8"
)
func cleanInactiveUsers(ctx context.Context, rdb *redis.Client) error {
threshold := time.Now().AddDate(0, 0, -30).Unix()
// 先查看待删除数量
count, err := rdb.ZCount(ctx, "active:users", "-inf", fmt.Sprintf("%d", threshold)).Result()
if err != nil {
return err
}
fmt.Printf("待清理用户数: %d\n", count)
deleted, err := rdb.ZRemRangeByScore(ctx, "active:users", "-inf", fmt.Sprintf("%d", threshold)).Result()
if err != nil {
return err
}
fmt.Printf("已清理用户数: %d\n", deleted)
return nil
}Go客户端的方法名是ZRemRangeByScore，注意大小写与命令行的差异。threshold用30天前的Unix秒级时间戳，凡是最后活跃时间早于这个值的用户都会被移出集合。
三、与ZREMRANGEBYRANK的区别及生产环境注意事项
Redis里还有一条长得很像的命令ZREMRANGEBYRANK，它是按排名（索引）而不是按分数删除的。举个例子，集合里有100个成员，ZREMRANGEBYRANK key 0 9删除的是分数最低的10个成员，不管它们的分数具体是多少；而ZREMRANGEBYSCORE删除的是分数落在指定区间内的成员，不管有多少个。两者的选择标准完全不同，简单说：关心分数值用SCORE版本，关心数量用RANK版本。
需要特别注意的是阻塞问题。ZREMRANGEBYSCORE的时间复杂度是O(log(N)+M)，其中N是集合总元素数，M是被删除的元素数。如果集合里有几百万个元素，一次删除几十万条，Redis主线程会长时间被占用，期间所有其他请求都会被阻塞，线上服务可能出现明显的延迟抖动。
对于大集合的安全删除，推荐两种做法。第一种是分批删除，每次只删一小段分数区间，循环执行直到清完：
# 每次最多删除1000条，通过限制max边界控制批量大小 # 用ZREVRANGE先取出第1000个元素的分数作为边界，分批推进
第二种做法是用UNLINK配合临时键迁移，把要保留的数据写到新键，再用RENAME原子替换旧键，最后UNLINK旧键，整个过程不会产生大删除阻塞。此外，如果业务允许，也可以考虑用Redis的过期策略代替手动清理，比如给整个键设置TTL，让它自然过期。
最后提醒一点：ZREMRANGEBYSCORE删除的只是成员本身，如果成员对应的业务数据存在其他键里，记得同步清理，否则容易产生孤儿数据。删除后集合变为空时，整个键会被自动移除，这一点和List、Set的行为一致。
RedisZREMRANGEBYSCORE有序集合修改时间：2026-09-11 12:20:41