在Redis的命令列表中，TOUCH是一个低调但极具价值的命令。它允许开发者在不对Key进行实际读写的前提下，直接刷新Key的最后访问时间。这一能力对于精细控制缓存淘汰策略、模拟用户访问行为以及调试LRU/LFU算法都至关重要。理解TOUCH的工作原理，能够帮助我们更精准地管理Redis内存中Key的冷热状态，避免热点数据被意外淘汰。本文将从命令语法、底层机制、实际用途和注意事项四个方面展开，帮助你彻底掌握Redis TOUCH命令。
TOUCH命令的基本语法与返回值
TOUCH命令的语法非常简洁，允许一次操作一个或多个Key。其标准格式为：TOUCH key [key ...]。命令执行后，Redis会更新这些Key的最后访问时间，但不会返回Key对应的值，也不会修改Key本身的数据。返回值是一个整数，表示成功被更新访问时间的Key数量。如果某个Key不存在，它不会被计入返回值，同时也不会引发错误。
例如，在redis-cli中执行以下命令：
127.0.0.1:6379> SET user:1001 "Alice" OK 127.0.0.1:6379> TOUCH user:1001 user:1002 (integer) 1 127.0.0.1:6379> TOUCH user:1001 (integer) 1
第一次TOUCH返回1，因为只有user:1001存在，user:1002不存在。第二次TOUCH再次成功更新了user:1001的访问时间，返回1。值得注意的是，TOUCH命令对Key的存在性检查与GET等命令不同，它不会触发键空间通知中的读事件，因为从语义上讲，它不是一次真正的数据读取操作。
TOUCH命令从Redis 3.2.1版本开始引入，最初设计目的就是为了在LRU淘汰策略下提供一种轻量级的“预热”手段。与GET命令相比，TOUCH不会产生网络传输数据值的开销，也不会增加Key的引用计数，因此性能极高，适合在循环或脚本中批量调用。
TOUCH命令的底层实现与LRU/LFU的关系
要理解TOUCH命令，必须了解Redis内部对象结构。每个Redis键值对中的值对象（redisObject）都包含一个lru字段，该字段在Redis 6.0之前是24位，用于存储秒级Unix时间戳；从Redis 6.0开始，随着LFU策略的加入，lru字段被重新设计为16位，其中高8位用于LFU计数，低8位用于分钟级时间戳。当内存淘汰策略设定为volatile-lru或allkeys-lru时，Redis依据这个字段来判断Key的空闲时间，进而决定淘汰优先级。
TOUCH命令的内部实现会调用lookupKeyReadWithFlags函数，但设置了LOOKUP_NOTOUCH标志的取反逻辑，即强制更新访问时间而不做其他操作。具体来说，命令处理函数touchCommand会迭代客户端传入的所有Key，对每个Key执行查找，如果Key存在，则更新其lru字段为当前时间（在LFU模式下会提升计数或更新时间戳），并将成功更新的计数加一。由于它跳过了解序列化和返回数据值的步骤，所以比GET命令更加轻量。
与OBJECT IDLETIME key命令配合使用时，可以清晰看到TOUCH的效果。OBJECT IDLETIME返回自该Key最后一次被访问以来经过的秒数。执行TOUCH之前，IDLETIME可能是一个较大的值；执行TOUCH之后，IDLETIME会被重置为0或很小的值。例如：
127.0.0.1:6379> SET cache:page1 "data" OK # 等待10秒后 127.0.0.1:6379> OBJECT IDLETIME cache:page1 (integer) 10 127.0.0.1:6379> TOUCH cache:page1 (integer) 1 127.0.0.1:6379> OBJECT IDLETIME cache:page1 (integer) 0
这个例子直观展示了TOUCH如何重置Key的空闲时间。在LFU模式下，TOUCH会根据策略更新访问频率计数器或时间戳，具体行为取决于Redis版本和LFU衰减配置，但核心目标一致：让Key看起来更活跃，从而降低被淘汰的概率。
TOUCH命令的典型使用场景与注意事项
TOUCH的第一个典型场景是缓存预热与手动标记热点。在缓存系统中，有时已知某些Key即将被高频访问，但尚未收到真实请求。通过提前执行TOUCH，可以将这些Key的访问时间置为当前时间，避免它们在LRU淘汰过程中因“看似空闲”而被清除。例如，在促销活动开始前，对活动页面的缓存Key批量执行TOUCH，确保活动期间缓存命中率最大化。
第二个场景是模拟用户访问行为。在测试环境或压力测试中，开发者需要模拟大量Key被持续访问，以观察Redis内存淘汰行为。使用TOUCH命令可以快速刷新Key的访问时间，而无需传输真实数据，大幅降低测试客户端与Redis之间的网络开销。结合脚本，可以在短时间内构造出符合预期分布的“热Key”和“冷Key”。
使用时需要注意几个限制。首先，在Redis Cluster集群模式下，如果TOUCH命令传入的多个Key分布在不同的slot（哈希槽）上，命令会返回CROSSSLOT错误。解决方法是按slot分组，或者使用hash tag让相关Key映射到同一slot。其次，TOUCH不会触发键空间通知中的读类事件，因此依赖通知机制做缓存同步的系统不会收到任何信号。最后，TOUCH操作虽然开销小，但在超大循环中频繁调用仍可能产生可观的CPU负载，建议使用管道（pipeline）或Lua脚本批量处理。
代码示例与性能对比
在实际项目中使用TOUCH命令，可以通过各种Redis客户端轻松完成。以Python的redis-py为例：
import redis
r = redis.Redis(host='localhost', port=6379, decode_responses=True)
# 设置一个Key
r.set('product:detail:123', '{"name": "Laptop"}')
# 使用touch方法刷新访问时间
updated = r.touch('product:detail:123')
print(f"成功更新的Key数量: {updated}")
# 查看空闲时间
idletime = r.object('IDLETIME', 'product:detail:123')
print(f"空闲时间: {idletime}秒")
如果需要对多个Key执行TOUCH，推荐使用Lua脚本保证原子性并减少网络往返。下面是一个简单的Lua脚本示例：
-- KEYS[1..N] 是需要touch的key列表
local count = 0
for i, key in ipairs(KEYS) do
if redis.call('EXISTS', key) == 1 then
redis.call('TOUCH', key)
count = count + 1
end
end
return count
性能方面，TOUCH命令明显优于等价的GET操作。由于TOUCH不需要将值数据发送回客户端，网络传输量几乎为零；同时Redis内部跳过了数据序列化和复制缓冲区的写入，CPU占用也更低。在本地基准测试中，对相同数量的Key执行TOUCH通常比GET快30%到50%，尤其在值数据很大的情况下差距更为明显。因此，在只关心访问时间而不需要值的场景里，TOUCH是首选方案。
总而言之，Redis TOUCH命令是一个小而美的工具，它填补了只刷新访问时间而不读取数据这一需求的空白。掌握它的用法和原理，能够让缓存管理和性能优化更加得心应手。
Redis TOUCH最后访问时间LRU修改时间：2026-08-23 02:13:07