Redis doesn't have the 'client maint_notifications' subcommand

[cxljs]

When using go-redis version 9.15.0 or above, an error is returned:

redis.go:464: auto mode fallback: maintnotifications disabled due to handshake error: ERR unknown subcommand 'maint_notifications'.

The reason is go-redis call the command in function:

go-redis/commands.go

Line 525 in 819f01b

func (c cmdable) ClientMaintNotifications(ctx context.Context, enabled bool, endpointType string) *StatusCmd {

but Redis does not have the 'client maint_notifications' subcommand. Is this a new Redis command that hasn't been released yet?

[htemelski-redis]

Hello @cxljs 9.15.0 was released by mistake, and we've tried to retract the version (although unsuccessfully).
https://github.com/redis/go-redis/blob/master/go.mod#L13
The next version of the library would be 9.16.0

[cxljs]

@htemelski-redis Got it. Thank you for your explanation.

[nikolaydubina]

@htemelski-redis this error also affected us in production. could you file bug report to https://github.com/golang/go? redis is big org, you guys can sway and made Go/Google team to look into it.

[htemelski-redis]

Hello @nikolaydubina, it was a mistake on our end, for which I'd like to apologize

[hongster]

@cxljs Shouldn't this issue remain opened?

As of latest version (v9.16.0), the issue is still happening.

go-redis/commands.go

Line 526 in f195656

args := []interface{}{"client", "maint_notifications"}

[st7yws]

Redis: v8.2.2
go redis: v9.16.0

redis.go:478: auto mode fallback: maintnotifications disabled due to handshake error: ERR unknown subcommand 'maint_notifications'. Try CLIENT HELP.

[fapo85]

@htemelski-redis Thank you very much for your work, but I can also confirm that the error is still present.
redis version 8.2.2

github.com/redis/go-redis/v9 v9.16.0
redis: 2025/10/26 18:45:17 redis.go:478: auto mode fallback: maintnotifications disabled due to handshake error: ERR unknown subcommand 'maint_notifications'. Try CLIENT HELP.

github.com/redis/go-redis/v9 v9.15.0
..\..\go\pkg\mod\github.com\redis\go-redis\v9@v9.15.0\internal\pool\pool.go:809:47: undefined: errUnexpectedRead

github.com/redis/go-redis/v9 v9.14.0
Everything works as expected in this version.

[ndyakov]

Hello @cxljs, @fapo85, @st7yws, @hongster and @nikolaydubina. What you are observing in v9.16.0 is an info log. It is true, that a maint_notifications subcommand is tried to be delivered to the server and based on the response, the client will decide if it will enable or disable the maintnotifications feature. In other words, the client is trying to detect if the server supports maintenance notifications by default (the default option of

go-redis/maintnotifications/config.go

Line 74 in a3a369b

Mode Mode

is ModeAuto).

You can disable this by setting it to ModeDisabled.

	rdb1 := redis.NewClient(&redis.Options{
		Addr: "localhost:6379",

		// Explicitly disable maintenance notifications
		// This prevents the client from sending CLIENT MAINT_NOTIFICATIONS ON
		MaintNotificationsConfig: &maintnotifications.Config{
			Mode: maintnotifications.ModeDisabled,
		},
	})

I will add an example in the examples folder later this week, but generally speaking - if you are not using redis enterprise or redis cloud, you do not need the maintnotifications and it should be safe to disable them.

@fapo85 v9.15.0 was retracted as it was released by mistake, the err should be resolved in v9.16.0