Repository navigation
Description
Duplicate Pub/Sub messages after Redis Sentinel failover
I'm seeing an intermittent issue where the same Pub/Sub message is delivered twice after a Sentinel failover. It doesn't happen on every switch, but when it does, the duplicates continue after the connection has recovered. In one test they continued for the full two minutes I kept traffic running.
I reproduced this in a standalone .NET console application using StackExchange.Redis directly. It subscribes once to a single pattern, and a separate publisher sends each numbered message once.
Environment
- StackExchange.Redis 3.4.31 from NuGet.
- Redis and Sentinel 8.0.3.
- .NET 10, running in Linux Docker containers on Docker Desktop for Windows.
- Tested with both RESP2 and RESP3. Either protocol can reproduce it, although the result varies between runs.
- Two setups: one primary + two replicas with three Sentinels, and one primary + four replicas with five Sentinels. Quorum was two and three respectively.
How to reproduce
-
Connect through Sentinel using
serviceName=mymasterand subscribe once torepro.events.*. -
From a separate publisher, send a unique numbered ID to
repro.events.0about every 100 ms. Send each ID once, directly to the primary reported by Sentinel. -
Keep publishing and trigger a failover:
redis-cli -h sentinel-0 -p 26379 SENTINEL FAILOVER mymaster -
Leave the consumer running and check how many times each ID reaches the callback. Repeat the switch if necessary, since the issue is intermittent.
The consumer is essentially:
using var connection = await ConnectionMultiplexer.ConnectAsync(
"sentinel-0:26379,sentinel-1:26379,sentinel-2:26379," +
"serviceName=mymaster,abortConnect=false," +
"connectTimeout=5000,syncTimeout=5000,protocol=resp3");
var counts = new ConcurrentDictionary<string, int>();
await connection.GetSubscriber().SubscribeAsync(
RedisChannel.Pattern("repro.events.*"), (_, message) =>
{
var id = message.ToString();
var count = counts.AddOrUpdate(id, 1, (_, previous) => previous + 1);
Console.WriteLine($"id={id} count={count}");
});There is only one subscription, with no overlapping literal subscription or extra calls to Subscribe on reconnect. The attached project contains the complete subscriber example. It needs a reachable Sentinel setup and a separate publisher.
What I observed
In one five-node test, the publisher sent 1,310 unique IDs. The RESP3 consumer received 1,226 of those IDs more than once. Packet captures showed one PUBLISH per ID, followed by two pmessage deliveries from different Redis nodes to the same consumer.
For example:
Message ID: promotion1-85
PUBLISH commands: 1
First delivery from: 172.20.0.5:6379
Second delivery from: 172.20.0.3:6379
The consumer still had subscriptions on two Redis nodes after failover had settled. RESP2 recovered normally in that particular run. In a separate three-node test, both protocols duplicated messages: 1,226 repeated IDs with RESP2 and 1,184 with RESP3.
I expect some messages to be lost while failover is happening. The concern here is the persistent duplicate delivery once traffic has resumed. The captures used for these examples had no reported packet drops or parsing gaps.
Possible cause
Looking at the source, I suspect two subscription-restoration paths can overlap before the first SUBSCRIBE/PSUBSCRIBE acknowledgement arrives:
ServerEndPoint.OnFullyEstablishedandConnectionMultiplexer.ReconfigureAsynccan both callEnsureSubscriptions(CommandFlags.FireAndForget).SingleNodeSubscriptionrecords its current server when the acknowledgement is processed. Until then, another restore can still see the subscription as disconnected and choose another node.- If both attempts succeed, the later acknowledgement replaces the recorded endpoint while the other physical subscription remains active.
This would explain the two deliveries from different nodes. One of those nodes can be a replica; it isn't always the old primary.
The source I checked was commit 9d17974fcade6c89b29b233030fe281e75f9ab1c, particularly Subscription.cs, ResultProcessor.cs, and ServerEndPoint.cs.
Regression test and local patch
I've attached a test using the repository's in-process test server. It holds the first subscription response, starts a restore to a second node, and checks whether a second registration is created before the first is acknowledged. The initial eight cases failed against the unchanged source.
I also have a local patch that coordinates restoration through the acknowledgement and prevents a late response from replacing a newer subscription. It also cleans up obsolete registrations and checks the source connection before dispatching a message.
The patched client passed 104 recovery events across the three-node and five-node setups, with no duplicate frames or callbacks observed. The five-node tests included Sentinel restarts and an outage with the primary and two Sentinels paused. Messages were still lost during failover, so this doesn't provide replay or a general exactly-once guarantee.
I also noticed recovery delays from concurrent Sentinel discovery queries. The local candidate includes an additional change to acquire the reconfiguration gate before discovery; that could be reviewed separately.
Activity
mgravell commentedon Nov 9, 2026
Will look, thanks
Harden the subscribe-claim handshake against the residual adoption race