1
0
mirror of https://github.com/redis/go-redis.git synced 2025-10-24 19:32:57 +03:00

add design decision comment

This commit is contained in:
Nedyalko Dyakov
2025-10-15 14:51:18 +03:00
parent 90bfdb3aa3
commit 07283ecfc6

View File

@@ -319,9 +319,15 @@ func (c *baseClient) connReAuthCredentialsListener(poolCn *pool.Conn) (auth.Cred
c.reAuthConnection(), c.reAuthConnection(),
c.onAuthenticationErr(), c.onAuthenticationErr(),
) )
// main case where the connection can be stuck in the listener for a long time is when we have a handoff // Design decision: The main case we expect the connection to be in a non-usable state is when it is being reconnected
// so we set the checkUsableTimeout to the handoff timeout if maintnotifications are enabled // during a handoff from maintnotifications.
// the default timeout if no maintnotifications config is provided is 1 second // Setting the checkUsableTimeout to the handoff timeout if maintnotifications are enabled
// the default timeout if no maintnotifications are disabled is going to be 1 second.
//
// Note: Due to the auto by default mode of MaintNotificationsConfig
// the timeout for the first connection will probably be the value of MaintNotificationsConfig.HandoffTimeout
// (15s by default) which is not ideal if maintnotifications are not needed, but safer than timing out in the case
// of enabling maintnotifications later.
if c.opt.MaintNotificationsConfig != nil && c.opt.MaintNotificationsConfig.Mode != maintnotifications.ModeDisabled { if c.opt.MaintNotificationsConfig != nil && c.opt.MaintNotificationsConfig.Mode != maintnotifications.ModeDisabled {
newCredListener.SetCheckUsableTimeout(c.opt.MaintNotificationsConfig.HandoffTimeout) newCredListener.SetCheckUsableTimeout(c.opt.MaintNotificationsConfig.HandoffTimeout)
} }