nginx config_error ai_generated true

upstream: inconsistent hash distribution

ID: nginx/upstream-hash-inconsistent

Also available as: JSON · Markdown
78%Fix Rate
82%Confidence
3Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
1 active

Root Cause

Upstream hash-based load balancing distributing unevenly.

generic

Workarounds

  1. 90% success Use consistent hash: hash consistent
  2. 85% success Use ip_hash for session affinity based on client IP

Dead Ends

Common approaches that don't work:

  1. Use round-robin instead 72% fail

    Loses session affinity

  2. Add more upstream servers without rehashing 68% fail

    Redistributes existing sessions