Redis PEXPIRETIME 怎样读取键的毫秒级过期时间

如果缓存排查需要知道“这个键会在什么绝对时间过期”，可以使用 Redis 的 PEXPIRETIME。它返回 Unix 毫秒时间戳，而不是从当前时刻开始倒数的剩余毫秒数；因此更适合和业务事件时间、日志时间或任务截止时间放在同一条时间线上比较。

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

PEXPIRETIME key 的返回值有三种含义：有效的绝对过期时间、-1（键存在但没有过期时间）和 -2（键不存在）。不要把 -1 当成“马上过期”，也不要把 -2 当成 Redis 服务异常。

• PEXPIRETIME 的单位是 Unix 毫秒时间戳，Redis 7.0.0 起提供。
• 它只读取键的过期元数据，时间复杂度是 O(1)。
• 需要剩余时长时使用 PTTL；需要秒级绝对时间时可以使用 EXPIRETIME。

先确定 PEXPIRETIME 返回的是什么

PEXPIRETIME 返回的是绝对 Unix 过期时间，单位为毫秒。例如返回 33177117420000，它代表一个时间点，而不是“还剩多少毫秒”。这和 PTTL 的语义完全不同：PTTL 返回从当前读取时刻开始计算的剩余时长。

# PEXPIRETIME 读取绝对过期时间，单位是 Unix 毫秒
redis-cli PEXPIRETIME session:1001

# PTTL 读取相对当前时刻的剩余毫秒数
redis-cli PTTL session:1001

排查时可以把二者放在一起理解：绝对时间适合和订单截止时间、定时任务时间比较；剩余时间适合判断缓存是否需要续期。不要拿 PEXPIRETIME 的结果直接当成倒计时数，也不要用两次 PTTL 的结果拼出业务事件时间。

用 PEXPIREAT 和 PEXPIRETIME 读取时间点

为了理解命令的输入输出，可以先用 PEXPIREAT 写入一个明确的 Unix 毫秒时间戳，再用 PEXPIRETIME 读取。两条命令使用同一个时间单位，避免把秒和毫秒混在一起。

# 先写入一个绝对 Unix 毫秒时间戳
redis-cli SET session:1001 active
redis-cli PEXPIREAT session:1001 33177117420000

# 读取刚写入的绝对过期时间，返回整数毫秒时间戳
redis-cli PEXPIRETIME session:1001

如果程序从 Unix 秒时间戳转换而来，写入前要明确乘以 1000；如果时间已经是毫秒，就不要再次放大。客户端封装最好把参数命名为 expireAtMillis，比单独使用 expireAt 更能提醒调用者单位。

这个命令的读取复杂度是 O(1)，但它只能告诉你 Redis 当前保存的过期元数据。它不会承诺读取后键一定还会存在：键可能在下一次访问前已经过期，所以业务上不要把读取结果当作锁或订单状态的独占凭证。

区分 -1、-2 和有效时间戳

Redis 官方文档把返回结果分成三种情况。返回非负整数时，说明键有过期时间，整数就是 Unix 毫秒时间戳；返回 -1 时，键存在但没有关联的过期时间；返回 -2 时，键不存在。

# 读取不存在的 key，-2 表示 key 不存在
redis-cli DEL session:missing
redis-cli PEXPIRETIME session:missing

# 读取没有设置过期时间的 key，-1 表示永久存在（除非被删除）
redis-cli SET session:permanent active
redis-cli PEXPIRETIME session:permanent

应用层最好先判断 Redis 命令是否执行失败，再判断返回整数的三种业务含义。这样可以把“连接失败、权限错误、类型错误”和“正常返回 -1/-2”分开记录，监控告警也不会因为大量缓存未命中而误报。

选择 PEXPIRETIME、EXPIRETIME 还是 PTTL

三个命令都用于读取过期信息，但回答的问题不同。PEXPIRETIME 和 EXPIRETIME 都返回绝对过期时间，区别只是毫秒与秒；PTTL 返回相对当前时刻的剩余毫秒数。

如果只是要实现“剩余 30 秒就刷新”，应读取 PTTL，而不是读取 PEXPIRETIME 后再用本地时钟相减。后者会引入客户端时钟偏差和网络往返时间，除非你确实需要一个可落日志的绝对时间点。

为什么读到 -1？通常是键存在但从未设置过期时间，或者业务逻辑在更新键时丢失了 TTL。先确认写入命令和更新策略，再决定是否补充过期时间。

为什么一会儿是时间戳，一会儿变成 -2？键可能在两次读取之间自然过期或被删除。读取结果只能描述读取瞬间的状态，不能代替后续业务操作的原子性。

PEXPIRETIME 返回的是秒还是毫秒？是毫秒；同一语义的秒级命令是 EXPIRETIME。生成参数时要把时间单位写进变量名和接口文档。