---
title: "Redis Pub/Subの使い方：PUBLISHとSUBSCRIBEの実装例、メッセージ消失の対策とStreamsとの使い分け【Redis 8.10系】"
url: "https://www.issoh.co.jp/tech/details/19865/"
published: 2026-11-16
updated: 2026-11-16
categories: ["データベース"]
publisher: "株式会社一創"
---

# Redis Pub/Subの使い方：PUBLISHとSUBSCRIBEの実装例、メッセージ消失の対策とStreamsとの使い分け【Redis 8.10系】

Redis Pub/Subは、PUBLISHでチャネルに送ったメッセージを、そのときSUBSCRIBEしている接続すべてへ即座に配る機能です。手軽な反面、メッセージはRedisに残らず、受け手がいなければ黙って消えます。この記事では、redis-cliとredis-py 8.1系で動く実装例を示しながら、Redis公式ドキュメントとredis.conf 8.10.3をもとに、消える条件と防ぎ方を整理しました。後半では、出力バッファ上限やACLのチャネル権限、Cluster環境のSharded Pub/Sub、Streamsへ切り替える判断基準まで扱います。

## まとめ：Pub/Subは接続中の相手への即時通知用、再処理が要るならStreamsへ

Redis Pub/Subの配信は「最大1回（at-most-once）」です。購読者がいない、切断中だった、受信が遅れて強制切断された、のどれかに当たったメッセージは二度と届きません。PUBLISHの返り値は受け取った購読者数なので、0が返ったら誰にも届いていないと判断できます。

向いているのは、WebSocketサーバーを複数台に並べたときのメッセージ中継や、各サーバーのローカルキャッシュを消す合図のように、取りこぼしても次の通知や再読み込みで回復できる用途です。注文や決済のイベント、ジョブの受け渡しのように1件でも欠けると困るものは、最初からRedis Streamsで組んでください。

本番では、遅い購読者を切る出力バッファ上限（既定32MB）と、Redis 7.0から既定で全チャネル拒否になったACLの2点を先に確認します。

## Redis Pub/Subの仕組み：チャネル配信とat-most-onceの配信保証

Pub/Subで覚える要素は、チャネル、発行側の`PUBLISH`、購読側の`SUBSCRIBE`の3つだけです。ただし購読した接続の扱いと配信保証に癖があります。

### PUBLISHはチャネル名を指定して送り、届いた購読者数を整数で返す

[PUBLISHのドキュメント](https://redis.io/docs/latest/commands/publish/)によると、構文は`PUBLISH channel message`で、Redis 2.0.0から使えます。発行側は宛先を知る必要がなく、チャネル名だけを指定します。返り値は、そのメッセージを受け取ったクライアントの数です。

計算量はO(N+M)で、Nはそのチャネルの購読者数、Mは全クライアントが登録したパターン購読の総数です。`PSUBSCRIBE`のパターンを大量に登録すると、関係のないチャネルへのPUBLISHも含め、すべての発行が遅くなります。パターンはサービス単位など少数に抑えます。

### SUBSCRIBEした接続はRESP2では購読専用になり、GETやSETを打てない

[Redis公式のPub/Subドキュメント](https://redis.io/docs/latest/develop/pubsub/)によると、RESP2で購読中の接続が送れるのは`SUBSCRIBE`・`PSUBSCRIBE`・`SSUBSCRIBE`とそれぞれの解除、`PING`・`QUIT`・`RESET`の9種類だけです。`GET`を送ってもエラーになります。

このため、アプリでは発行用と購読用の接続を分けるのが基本です。[HELLO](https://redis.io/docs/latest/commands/hello/)で`HELLO 3`を送ってRESP3に切り替えた接続は、購読中でも任意のコマンドを打てます。redis-cliの購読モードは解除コマンドも受け付けず、抜けるにはCtrl-Cを押します。

### at-most-once配信：購読者が不在・切断中のメッセージは再送されない

公式ドキュメントで明記されているPub/Subの配信方式は、at-most-onceです。サーバーが一度送ったメッセージは再送されず、購読側がエラーや回線断で処理できなければ失われます。購読者が0人のときのPUBLISHも、エラーにはならず0を返して終わります。

消える場面は次の3つです。

- 発行した時点で、そのチャネルを購読している接続が無い
- 購読側がネットワーク断や再起動で切断していた
- 購読側の受信が追いつかず、出力バッファ上限でサーバーに切断された

3つ目は購読側のコードに問題が無くても起きます。設定値は後半の運用設定の章で扱います。

### チャネルはDB番号やキー空間と無関係で、環境名の接頭辞で分ける設計

Pub/Subはキー空間と切り離されており、`SELECT`で選ぶデータベース番号も効きません。ドキュメントには、DB 10で発行したメッセージがDB 1の購読者に届くと書かれています。

同じRedisを検証環境と本番で共有している場合、DB番号を分けてもメッセージは混ざります。公式の推奨どおり、`app:prod:orders:created`のように環境名をチャネル名の先頭に付けてください。この命名は、後述するACLのチャネル権限やパターン購読とも相性が良い形です。

## redis-cliの2端末でPUBLISHとSUBSCRIBEを試し、返り値を読む手順

手元で動きを確かめるなら、Dockerで1台起動して端末を2つ開くのが早道です。Redis本体の起動方法は[RedisをDockerで動かす手順：compose.yamlでの永続化・redis.conf・パスワード設定](https://www.issoh.co.jp/tech/details/19855/)で詳しく扱っています。

### Redis 8.10をDockerで起動し、購読側の端末でSUBSCRIBEを実行する

2026年11月時点の最新安定版は[Redis 8.10.3](https://github.com/redis/redis/releases/tag/8.10.3)（2026年10月26日公開）です。購読側の端末で次を実行すると、プロンプトが戻らず待ち受け状態になります。

```
# Redis 8.10系を起動する
docker run -d --name redis-pubsub -p 6379:6379 redis:8.10

# 端末1（購読側）：2つのチャネルを購読する
docker exec -it redis-pubsub redis-cli SUBSCRIBE app:dev:orders:created app:dev:orders:canceled
```

購読が成立すると、チャネルごとに`subscribe`、チャネル名、現在の購読数の3要素が返ります。2つ目のチャネルでは購読数が2になります。

### 発行側からPUBLISHし、返り値の購読者数と受信した3要素の配列を読む

別の端末からメッセージを送ります。JSONを送るときは、シェルで引用符が崩れないよう単引用符で囲みます。

```
# 端末2（発行側）：購読者がいるチャネルへ送る
docker exec -it redis-pubsub redis-cli PUBLISH app:dev:orders:created '{"order_id":1001}'
# (integer) 1  受け取った購読者数

# 誰も購読していないチャネルへ送る
docker exec -it redis-pubsub redis-cli PUBLISH app:dev:orders:shipped '{"order_id":1001}'
# (integer) 0  エラーにはならず、メッセージは消える
```

端末1には`message`、チャネル名、本文の3要素が表示されます。発行側でこの返り値を記録しておくと、「送ったのに届かない」問い合わせを受けたときに、購読側が落ちていたのかを後から判断できます。

### PSUBSCRIBEのパターン購読と、messageとpmessageを二重に受ける条件

[PSUBSCRIBE](https://redis.io/docs/latest/commands/psubscribe/)は、glob形式のパターンで複数のチャネルをまとめて購読します。

```
# 端末1：注文系のチャネルすべてを購読する
docker exec -it redis-pubsub redis-cli PSUBSCRIBE 'app:dev:orders:*'

# 端末2：どの注文チャネルに送っても届く
docker exec -it redis-pubsub redis-cli PUBLISH app:dev:orders:refunded '{"order_id":1001}'
```

パターン経由で届くメッセージの種類は`pmessage`で、マッチしたパターン、実際のチャネル名、本文の4要素で構成される形式です。同じ接続で`SUBSCRIBE foo`と`PSUBSCRIBE f*`の両方をしていると、1回のPUBLISHで`message`と`pmessage`の2通を受け取ります。購読側で同じ処理が2回走る原因になるので、1つの接続では片方だけにします。

## redis-py 8.1系で購読ループを書くPythonコードと再接続時の注意

Pythonでは[redis-py](https://pypi.org/project/redis/)を使います。2026年11月時点の最新は8.1.0（2026年7月30日公開）で、Python 3.10以上が必要です。

### pubsub()とlisten()で購読ループを書く最小構成のPythonコード

[redis-pyのドキュメント](https://redis.readthedocs.io/en/stable/advanced%5Ffeatures.html)どおり、`r.pubsub()`で購読用のオブジェクトを作ります。`ignore_subscribe_messages=True`を付けると、購読成立の通知がループに流れてきません。

```
# subscriber.py（pip install "redis>=8.1"）
import json
import redis

r = redis.Redis(host="localhost", port=6379, decode_responses=True)
p = r.pubsub(ignore_subscribe_messages=True)
p.subscribe("app:dev:orders:created")

for message in p.listen():
    # message は type・channel・pattern・data を持つ dict
    order = json.loads(message["data"])
    print(message["channel"], order["order_id"])
```

```
# publisher.py
import json
import redis

r = redis.Redis(host="localhost", port=6379, decode_responses=True)
receivers = r.publish("app:dev:orders:created", json.dumps({"order_id": 1001}))
if receivers == 0:
    print("購読者がいないため、このメッセージは誰にも届いていない")
```

`decode_responses`を省くと、`channel`や`data`はバイト列で届きます。`listen()`はメッセージが来るまで止まるジェネレータで、受信以外に何もしないワーカー向きです。ほかの処理と同じループで回すなら、届いていなければ`None`を返す`get_message(timeout=1.0)`を使います。

### run\_in\_threadとハンドラ登録でWebアプリ内に受信スレッドを置く書き方

Webアプリの中で受信だけを裏で回すなら、チャネルごとにハンドラを登録して`run_in_thread`を呼びます。次の例は、他のサーバーから届いた合図でプロセス内のキャッシュを消す処理です。

```
import redis

local_cache = {}

def on_invalidate(message):
    # 他のサーバーが更新したキーを、自プロセスのキャッシュから捨てる
    local_cache.pop(message["data"], None)

r = redis.Redis(host="localhost", port=6379, decode_responses=True)
p = r.pubsub(ignore_subscribe_messages=True)
# コロンを含むチャネル名は dict で渡す
p.subscribe(**{"app:prod:cache:invalidate": on_invalidate})
worker = p.run_in_thread(sleep_time=0.01, daemon=True)

# アプリ終了時
worker.stop()
p.close()
```

v8.1.0のソースでは、ハンドラの無いチャネルを1つでも購読していると`run_in_thread`は例外を投げます。ドキュメントは、PubSubオブジェクトをスレッド間で受け渡すのは安全でないとも注意しています。受信スレッド専用のオブジェクトにし、発行には別の`Redis`インスタンスを使ってください。

### 切断時は自動で再購読されるが、切断中に発行されたメッセージは届かない

redis-pyは、接続が切れて張り直すときに、それまで購読していたチャネルとパターンを自動で登録し直します。v8.1.0の`on_connect`がこの処理を担っています。

ただし、ドキュメントが明記するとおり、切断していた間に発行されたメッセージは届きません。再購読が成功したログだけを見て「復旧した」と判断すると、その数秒から数分の欠落に気づけません。キャッシュ無効化の用途なら、再接続を検知したときにローカルキャッシュを全部捨てる処理を入れておけば、欠落による古いデータの表示を防ぐことが可能です。

## 遅い購読者と権限で詰まらないための出力バッファ・ACL・監視の設定値

開発環境では問題なく動いたPub/Subが本番で止まる原因は、ほとんどが購読側の処理速度と権限設定です。

### 出力バッファ上限pubsub 32mb 8mb 60で遅い購読者が切断される条件

[redis.conf 8.10.3](https://github.com/redis/redis/blob/8.10.3/redis.conf)の既定値は`client-output-buffer-limit pubsub 32mb 8mb 60`です。購読者向けの未送信データが32MBに達した瞬間、または8MB超が60秒続いた時点で、その接続は切断されます。コメントには、発行の速さに購読側の処理が追いつかないケースが典型例として挙がっています。

```
# 現在の上限を確認する
redis-cli CONFIG GET client-output-buffer-limit

# 上限で切断された累計回数と、いま一番大きい出力バッファ
redis-cli INFO stats | grep client_output_buffer_limit_disconnections
redis-cli INFO clients | grep client_recent_max_output_buffer
```

切断回数が増えているなら、上限を上げる前に見直す対象は購読側です。ハンドラ内でのDB書き込みや外部APIの呼び出しは、受信が詰まる原因です。受け取ったら内部のキューに積むだけにして処理は別スレッドへ回すか、処理が重い用途ならStreamsへ移します。上限を緩めると、詰まった分だけRedisのメモリが膨らみます。

### Redis 7.0から既定resetchannelsになったACLのチャネル権限の付け方

[ACLのドキュメント](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/security/acl/)によると、チャネル単位の権限はRedis 6.2から`&パターン`で付けられます。7.0からは`acl-pubsub-default`の既定が`resetchannels`になり、新しく作ったユーザーはどのチャネルにも発行・購読できません。6.x時代の手順でユーザーを作ると、PUBLISHが権限エラーになります。

```
# 本番の注文チャネルだけを発行・購読できるユーザー
ACL SETUSER orders-app on >change-this-password resetchannels &app:prod:orders:* +publish +subscribe +ping

# 権限を確かめる
ACL GETUSER orders-app
```

PUBLISHとSUBSCRIBEはチャネル名を許可パターンと照合しますが、`PSUBSCRIBE`は登録するパターンが許可パターンと文字列として一致する必要があります。上の例でパターン購読も許すなら、`+psubscribe`を足したうえで購読側は`app:prod:orders:*`そのものを指定します。

### PUBSUB NUMSUBとINFOのpubsub\_clientsで購読状況を確かめる

「購読側が生きているか」は、発行前にRedis側から確認できます。

```
# チャネルごとの購読者数（パターン購読者は含まない）
redis-cli PUBSUB NUMSUB app:prod:orders:created app:prod:cache:invalidate

# 登録されているパターンの総数
redis-cli PUBSUB NUMPAT

# 購読モードの接続数とチャネル・パターンの総数
redis-cli INFO clients | grep pubsub_clients
redis-cli INFO stats | grep -E 'pubsub_channels|pubsub_patterns|pubsubshard_channels'
```

[PUBSUB NUMSUB](https://redis.io/docs/latest/commands/pubsub-numsub/)はRedis 2.8.0からのコマンドです。[INFO](https://redis.io/docs/latest/commands/info/)の`pubsub_clients`は7.4で、`pubsubshard_channels`は7.0.3で追加された項目なので、古い版やマネージドサービスでは出ないことがあります。監視では、購読者数が想定の台数を下回ったら通知する設定にしておくと、消失に先回りできます。

## ClusterでのPub/Sub：全ノード伝播とSSUBSCRIBEによるスロット内配信

Redis Clusterでは、通常のPub/SubとSharded Pub/Subで、メッセージが流れる範囲が大きく違います。

### 通常のPUBLISHはクラスタバスで全ノードへ転送され、転送量がノード数分増える

PUBLISHのドキュメントによると、Clusterではどのノードに発行しても、メッセージは必要に応じて転送され、購読側はどのノードに接続していても受け取れます。代わりに、各メッセージはクラスタ内の全ノードへ伝わります。ノードを増やしても、Pub/Subの転送量は減りません。

返り値も、Clusterでの挙動に注意が必要です。Clusterでの`PUBLISH`の返り値は、発行したクライアントと同じノードにつながっている購読者だけを数えます。0が返っても、他のノードの購読者には届いている可能性があります。返り値で消失を判定する仕組みは、Clusterではそのまま使えません。

### SSUBSCRIBEとSPUBLISHでチャネルをスロットに割り当て、シャード内に閉じる

Redis 7.0で入った[SSUBSCRIBE](https://redis.io/docs/latest/commands/ssubscribe/)と[SPUBLISH](https://redis.io/docs/latest/commands/spublish/)は、キーと同じ計算でチャネルをスロットに割り当て、配信をそのスロットを持つシャードの中に閉じ込めます。購読側は、そのスロットのプライマリでもレプリカでも受け取れます。

```
# -c でリダイレクトを追う。チャネル名のハッシュでノードが決まる
redis-cli -c -p 7000 SSUBSCRIBE app:prod:room:42
redis-cli -c -p 7000 SPUBLISH app:prod:room:42 '{"text":"hello"}'
```

チャットルームのようにチャネル数が多く、1チャネルの購読者が限られる用途では、シャードを足すほど配信能力が伸びます。`{room:42}`のようなハッシュタグで関連キーと同じスロットに寄せる設計も可能です。スロットとMOVEDの仕組みは[Redis Clusterの構築手順：16384ハッシュスロットの仕組みとMOVED・ASK](https://www.issoh.co.jp/tech/details/19853/)で解説しています。redis-pyでは`ssubscribe()`で購読し、`get_sharded_message()`で受け取ります。

## Pub/SubとStreams・リストの使い分け：配信保証と再処理の要否で決める基準

判断の軸は1つです。メッセージが1件欠けたときに、業務上の損失が出るかどうかで決めます。

### Pub/Subを採用してよい用途：WebSocketの多台数配信とキャッシュ無効化通知

Pub/Subが活きるのは、受け手が今つながっている相手に限られ、欠けても次の通知や再読み込みで埋まる用途です。代表がWebSocketサーバーを複数台に並べたときの中継で、あるサーバーが受けたチャット投稿を、他のサーバーにつながる利用者へ届けます。FastAPIでの組み方は[FastAPIのWebSocket実装｜チャットの接続管理・切断処理とRedisで複数ワーカー対応](https://www.issoh.co.jp/tech/details/19697/)、WebSocket自体の仕組みは[WebSocketとは？仕組み・ハンドシェイクからNode.js実装・運用の判断まで](https://www.issoh.co.jp/tech/details/15815/)にまとめました。

もう1つは、各サーバーのメモリ上のキャッシュを消す合図です。合図を取りこぼしても、TTLが切れれば正しい値に戻ります。

### Streamsへ切り替える条件：取りこぼし不可・再処理・後から参加する消費者

[Redis Streams](https://redis.io/docs/latest/develop/data-types/streams/)はRedis 5.0から使えるデータ型で、メッセージがキーとして残ります。Pub/Subのドキュメント自身が、強い配信保証が必要ならStreamsを検討するよう案内しています。

| 観点       | Pub/Sub    | Streams                   |
| -------- | ---------- | ------------------------- |
| メッセージの保存 | 保存しない      | キーとして残る（MAXLENで上限）        |
| 配信保証     | 最大1回       | XACKによる確認で少なくとも1回にできる     |
| 切断中の分    | 失われる       | 再接続後に続きから読める              |
| 処理失敗時    | 再送なし       | 未確認分をXAUTOCLAIM（6.2から）で回収 |
| 受け手の分担   | 全員に同じものが届く | コンシューマグループで分担できる          |

```
# 発行：最大10万件を目安に古いものから捨てながら追加
XADD app:prod:orders MAXLEN ~ 100000 * order_id 1001
# コンシューマグループを作る（ストリームが無ければ作成）
XGROUP CREATE app:prod:orders billing $ MKSTREAM
# 受信：未配信分を最大10件、5秒待つ
XREADGROUP GROUP billing worker-1 COUNT 10 BLOCK 5000 STREAMS app:prod:orders >
# 処理が終わったIDを確認済みにする
XACK app:prod:orders billing 1731700000000-0
```

切り替える条件は、1件でも欠けると困る、処理に失敗したら再実行したい、後から起動したワーカーにも過去分を読ませたい、のどれかに当てはまる場合です。1つでも当てはまれば、Pub/Subに再送の仕組みを自作するより、最初からStreamsで組むほうが安く済みます。

### Pub/Subを採用しない場面：ジョブキュー・決済イベント・監査ログの受け渡し

次の3つはPub/Subで組みません。ジョブキューでは、ワーカーの再起動中に投入されたジョブが消える点が問題です。リトライや遅延実行まで要るなら、Redisを土台にした[BullMQ](https://www.issoh.co.jp/tech/details/17289/)のような専用ライブラリが向いています。決済や在庫のイベントは、欠けた1件が金額の不一致として残ります。監査ログは、後から読み直せないと用をなしません。

処理に失敗し続けるメッセージを退避させる設計は[デッドレターキュー（DLQ）とは](https://www.issoh.co.jp/tech/details/19037/)で扱っています。既存システムの通知やイベント連携をどの仕組みに載せるか、データ層の構成から見直したい場合は、[データベース設計・移行支援](https://www.issoh.co.jp/service/system/database/)で、現行のデータの流れの棚卸しから相談を受けています。

## よくある質問

Redis Pub/Subについて、検索されることの多い質問に答えます。

### Redis Pub/Subで送ったメッセージはRedisのどこかに保存されますか？

保存されません。PUBLISHされたメッセージは、その瞬間に購読している接続の出力バッファへ積まれるだけで、キーとしても履歴としても残りません。後から読み返したい、再起動をまたいで受け取りたいという要件があるなら、Redis Streamsを使ってください。Streamsはメッセージをキーとして保持し、MAXLENで件数の上限を決められます。

### 購読者が0人のときにPUBLISHしたメッセージはエラーになりますか？

エラーにはなりません。PUBLISHは受け取ったクライアント数として0を返し、メッセージは破棄されます。発行側のコードで返り値を見ていないと、誰にも届いていないことに気づけません。単一ノード構成なら返り値0をログや監視に流すと検知できます。Clusterでは返り値が同じノードの購読者だけを数えるため、PUBSUB NUMSUBやINFOの値と併せて判断してください。

### SUBSCRIBE中の接続でGETやSETなど通常のコマンドを使う方法はありますか？

RESP2の接続では使えず、購読と解除、PING、QUIT、RESETだけが許されます。HELLO 3でRESP3に切り替えた接続なら、購読中でも任意のコマンドを送れます。ただし、使っているクライアントライブラリがRESP3の受信を正しく扱えるかは別問題です。多くの場合は、購読用と通常コマンド用に接続を分けるほうが単純で、障害時の切り分けもしやすくなります。

### 期限切れを知らせるキースペース通知もPub/Subと同じく取りこぼしますか？

取りこぼします。[キースペース通知のドキュメント](https://redis.io/docs/latest/develop/pubsub/keyspace-notifications/)は、通知がPub/Subの仕組みで届くfire and forgetであり、切断中のイベントは失われると明記しています。redis.conf 8.10.3の既定は`notify-keyspace-events ""`で無効です。期限切れを受け取るには`Ex`を設定し、`__keyevent@0__:expired`を購読します。期限切れの検知で課金や予約の解放を行う設計は避けてください。

### Redis Pub/SubとMQTTやCloud Pub/Subはどう使い分ければよいですか？

Redis Pub/Subは、すでにRedisを使っているサーバー同士の軽い通知に向きます。IoT機器のように回線が不安定な端末とやり取りするならQoSを持つ[MQTT](https://www.issoh.co.jp/tech/details/15819/)、保存と再配信をマネージドで任せたいなら[Cloud Pub/Sub](https://www.issoh.co.jp/tech/details/12385/)が候補です。Redisの中で保証を強めたいだけなら、まずStreamsを検討してください。

## 関連記事

- [Redisとは：仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順](https://www.issoh.co.jp/tech/details/18876/)：Redis本体の仕組みとデータ型
- [FastAPIのWebSocket実装｜チャットの接続管理・切断処理とRedisで複数ワーカー対応](https://www.issoh.co.jp/tech/details/19697/)：Pub/Subで複数ワーカーにメッセージを中継する実装
- [Redis Clusterの構築手順：16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング](https://www.issoh.co.jp/tech/details/19853/)：Sharded Pub/Subの前提になるスロットの仕組み
- [Valkeyとは？Redisとの違い・Streamsの使い方と導入手順](https://www.issoh.co.jp/tech/details/9652/)：Streamsのコマンドと使い方
- [BullMQとは？v6のPostgreSQL対応・リトライとワーカー運用を実装者目線で解説](https://www.issoh.co.jp/tech/details/17289/)：取りこぼせないジョブを扱うキュー

---

出典: [Redis Pub/Subの使い方：PUBLISHとSUBSCRIBEの実装例、メッセージ消失の対策とStreamsとの使い分け【Redis 8.10系】](<https://www.issoh.co.jp/tech/details/19865/>)（株式会社一創）
