起始版本：1.0.0
時間復(fù)雜度：O(1)

對存儲在指定key的數(shù)值執(zhí)行原子的加1操作。

如果指定的key不存在，那么在執(zhí)行incr操作之前，會先將它的值設(shè)定為0。

如果指定的key中存儲的值不是字符串類型（fix：）或者存儲的字符串類型不能表示為一個整數(shù)，

那么執(zhí)行這個命令時服務(wù)器會返回一個錯誤(eq:(error) ERR value is not an integer or out of range)。

這個操作僅限于64位的有符號整型數(shù)據(jù)。

注意: 由于redis并沒有一個明確的類型來表示整型數(shù)據(jù)，所以這個操作是一個字符串操作。

執(zhí)行這個操作的時候，key對應(yīng)存儲的字符串被解析為10進制的64位有符號整型數(shù)據(jù)。

事實上，Redis 內(nèi)部采用整數(shù)形式（Integer representation）來存儲對應(yīng)的整數(shù)值，所以對該類字符串值實際上是用整數(shù)保存，也就不存在存儲整數(shù)的字符串表示（String representation）所帶來的額外消耗。

返回值
integer-reply:執(zhí)行遞增操作后key對應(yīng)的值。

例子

redis> SET mykey "10" OK redis> INCR mykey (integer) 11 redis> GET mykey "11" redis>

實例：計數(shù)器
Redis的原子遞增操作最常用的使用場景是計數(shù)器。

使用思路是：每次有相關(guān)操作的時候，就向Redis服務(wù)器發(fā)送一個incr命令。

例如這樣一個場景：我們有一個web應(yīng)用，我們想記錄每個用戶每天訪問這個網(wǎng)站的次數(shù)。

web應(yīng)用只需要通過拼接用戶id和代表當(dāng)前時間的字符串作為key，每次用戶訪問這個頁面的時候?qū)@個key執(zhí)行一下incr命令。

這個場景可以有很多種擴展方法:

通過結(jié)合使用INCR和EXPIRE命令，可以實現(xiàn)一個只記錄用戶在指定間隔時間內(nèi)的訪問次數(shù)的計數(shù)器
客戶端可以通過GETSET命令獲取當(dāng)前計數(shù)器的值并且重置為0
通過類似于DECR或者INCRBY等原子遞增/遞減的命令，可以根據(jù)用戶的操作來增加或者減少某些值 比如在線游戲，需要對用戶的游戲分?jǐn)?shù)進行實時控制，分?jǐn)?shù)可能增加也可能減少。
實例: 限速器
限速器是一種可以限制某些操作執(zhí)行速率的特殊場景。

傳統(tǒng)的例子就是限制某個公共api的請求數(shù)目。

假設(shè)我們要解決如下問題：限制某個api每秒每個ip的請求次數(shù)不超過10次。

我們可以通過incr命令來實現(xiàn)兩種方法解決這個問題。

實例: 限速器 1
更加簡單和直接的實現(xiàn)如下：

FUNCTION LIMIT_API_CALL(ip) ts = CURRENT_UNIX_TIME() keyname = ip+":"+ts current = GET(keyname) IF current != NULL AND current > 10 THENERROR "too many requests per second" ELSEMULTIINCR(keyname,1)EXPIRE(keyname,10)EXECPERFORM_API_CALL() END

這種方法的基本點是每個ip每秒生成一個可以記錄請求數(shù)的計數(shù)器。

但是這些計數(shù)器每次遞增的時候都設(shè)置了10秒的過期時間，這樣在進入下一秒之后，redis會自動刪除前一秒的計數(shù)器。

注意上面?zhèn)未a中我們用到了MULTI和EXEC命令，將遞增操作和設(shè)置過期時間的操作放在了一個事務(wù)中， 從而保證了兩個操作的原子性。

實例: 限速器 2
另外一個實現(xiàn)是對每個ip只用一個單獨的計數(shù)器（不是每秒生成一個），但是需要注意避免竟態(tài)條件。 我們會對多種不同的變量進行測試。

FUNCTION LIMIT_API_CALL(ip): current = GET(ip) IF current != NULL AND current > 10 THENERROR "too many requests per second" ELSEvalue = INCR(ip)IF value == 1 THENEXPIRE(value,1)ENDPERFORM_API_CALL() END

上述方法的思路是，從第一個請求開始設(shè)置過期時間為1秒。如果1秒內(nèi)請求數(shù)超過了10個，那么會拋異常。

否則，計數(shù)器會清零。

上述代碼中，可能會進入競態(tài)條件，比如客戶端在執(zhí)行INCR之后，沒有成功設(shè)置EXPIRE時間。這個ip的key 會造成內(nèi)存泄漏，直到下次有同一個ip發(fā)送相同的請求過來。

把上述INCR和EXPIRE命令寫在lua腳本并執(zhí)行EVAL命令可以避免上述問題（只有redis版本>＝2.6才可以使用）

local current current = redis.call("incr",KEYS[1]) if tonumber(current) == 1 thenredis.call("expire",KEYS[1],1) end

還可以通過使用redis的list來解決上述問題避免進入競態(tài)條件。

實現(xiàn)代碼更加復(fù)雜并且利用了一些redis的新的feature，可以記錄當(dāng)前請求的客戶端ip地址。這個有沒有好處 取決于應(yīng)用程序本身。

FUNCTION LIMIT_API_CALL(ip) current = LLEN(ip) IF current > 10 THENERROR "too many requests per second" ELSEIF EXISTS(ip) == FALSEMULTIRPUSH(ip,ip)EXPIRE(ip,1)EXECELSERPUSHX(ip,ip)ENDPERFORM_API_CALL() END

The RPUSHX command only pushes the element if the key already exists.

RPUSHX命令會往list中插入一個元素，如果key存在的話

上述實現(xiàn)也可能會出現(xiàn)競態(tài)，比如我們在執(zhí)行EXISTS指令之后返回了false，但是另外一個客戶端創(chuàng)建了這個key。

后果就是我們會少記錄一個請求。但是這種情況很少出現(xiàn)，所以我們的請求限速器還是能夠運行良好的。

總結(jié)

以上是生活随笔為你收集整理的Redis命令：INCR key加1的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。