异常教程

Redis Decr 命令（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在现代应用开发中，计数器（Counter）是常见的需求场景。无论是统计用户访问量、管理库存余量，还是实现限流策略，开发者都需要一种高效且可靠的计数机制。Redis Decr 命令正是为此而生的工具，它通过原子性操作实现键值的递减功能，尤其适合高并发场景下的计数需求。本文将从基础语法到实战案例，逐步解析这一命令的原理与应用，帮助开发者快速掌握其核心逻辑。

语法与基础用法

命令格式

DECR key

参数说明：

  • key：需要递减的键名，若键不存在，将初始化为 0 后执行递减操作。
  • 返回值：执行递减后的键值，若操作失败（如键的值无法转换为整数），返回 错误。

示例代码

127.0.0.1:6379> SET counter 10  
OK  

127.0.0.1:6379> DECR counter  
(integer) 9  

127.0.0.1:6379> DECR new_counter  
(integer) -1

形象比喻

可以将 DECR 命令想象为一个“自动售货机”的操作：用户每次按键（执行命令）时，机器内部的库存（键值）自动减少 1，且这一过程完全由机器内部逻辑保证，不会出现“卡币”或“重复出货”的问题。这种原子性操作，正是 Redis 的核心优势之一。

DECR 与 INCR 命令的对比

功能差异

命令操作类型初始值处理
INCR递增 +1不存在时设为 0
DECR递减 -1不存在时设为 0

典型场景选择

  • INCR：适用于点赞计数、点击量统计等“增长型”场景。
  • DECR：适用于库存扣减、剩余次数控制等“消耗型”场景。

示例对比

127.0.0.1:6379> INCR post_likes  
(integer) 1  

127.0.0.1:6379> DECR api_quota  
(integer) 99

典型应用场景与代码案例

场景 1：库存扣减系统

在电商场景中，商品库存的实时更新是关键。通过 DECR 可以确保扣减操作的原子性，避免并发场景下的“超卖”问题。

实现代码

import redis  

r = redis.Redis(host='localhost', port=6379, db=0)  

def deduct_stock(product_id):  
    # 执行原子递减操作  
    current_stock = r.decr(f'stock:{product_id}')  
    if current_stock < 0:  
        # 库存不足时回滚  
        r.incr(f'stock:{product_id}')  
        return False  
    return True  

product_id = 'SKU123'  
if deduct_stock(product_id):  
    print(f"成功扣减库存，当前剩余 {r.get(f'stock:{product_id}')}")  
else:  
    print("库存不足！")

场景 2：API 调用频率限制

通过 DECR 结合超时设置，可实现简单的限流逻辑。例如，用户每分钟最多调用 5 次 API：

127.0.0.1:6379> SET api_limit 5 EX 60  
OK  

127.0.0.1:6379> DECR api_limit  
(integer) 4  

127.0.0.1:6379> GET api_limit  
"0"

进阶用法与注意事项

1. 键值类型约束

DECR 只能作用于 字符串（String）类型的键。若键的值非整数（如 "123a"），Redis 会返回错误：

127.0.0.1:6379> SET invalid_key "100a"  
OK  
127.0.0.1:6379> DECR invalid_key  
(error) ERR value is not an integer or out of range

2. 幂等性与回滚机制

在分布式系统中，需结合事务或脚本确保操作的幂等性。例如，使用 WATCH 命令监控键值变化：

pipe = r.pipeline()  
pipe.watch('stock:SKU123')  
current = int(r.get('stock:SKU123') or 0)  
if current > 0:  
    pipe.multi()  
    pipe.decr('stock:SKU123')  
    pipe.execute()  
else:  
    pipe.unwatch()

3. 性能优化建议

  • 批量操作：若需频繁递减同一键，可结合 DECRBY 命令（如 DECRBY key 5）。
  • 内存控制：对无用键及时清理，避免占用过多内存。

常见问题与解决方案

问题 1：键不存在时的初始化行为

当键不存在时，DECR 会先设置键值为 0 再执行递减，结果为 -1。若希望初始化为其他值，需显式设置：

127.0.0.1:6379> SETNX stock 100  
(integer) 1

问题 2：负值的处理逻辑

若业务不允许键值为负数（如库存），需在应用层添加校验逻辑，或结合 GET 命令判断结果：

current = r.decr('stock')  
if current < 0:  
    # 回滚或触发异常  
    r.incr('stock')  
    raise ValueError("库存不足")

结论

Redis Decr 命令凭借其原子性、高性能和简洁的语法，成为计数场景的首选工具。无论是电商库存管理、API 限流，还是用户行为统计，开发者都能通过这一命令快速实现可靠计数逻辑。通过结合事务、脚本及合理的业务校验，开发者可进一步扩展其应用场景，满足复杂系统的计数需求。掌握 DECR 的核心原理与实践技巧，将为构建高并发应用奠定扎实的基础。

延伸学习：若需更灵活的计数操作，可探索 DECRBY、INCRBYFLOAT 等扩展命令，或结合 Lua 脚本 实现自定义逻辑。

最新发布

查看更多文章