TroubleshootingInitial

Redis Connection Issues

Troubleshoot common Redis connection problems

Redis Connection Issues

Connection Refused

Symptom: Connection refused to localhost:6379

Causes:

  • Redis server not running
  • Firewall blocking the port
  • Incorrect host/port configuration
  • Solutions:

  • Verify Redis is running:
  • redis-cli ping
    # Should return PONG
  • Check Redis is listening:
  • netstat -tlnp | grep 6379
  • Verify configuration:
  • cache:
      redis:
        host: ${REDIS_HOST:localhost}
        port: ${REDIS_PORT:6379}

    Authentication Failed

    Symptom: NOAUTH Authentication required

    Solution: Ensure password is configured:

    cache:
      redis:
        password: ${REDIS_PASSWORD}

    Connection Timeout

    Symptom: Connection timed out

    Solutions:

  • Increase timeout: connectTimeout: 5000
  • Check network latency to Redis server
  • Consider using connection pooling
  • About Cache Layer

    High-performance caching for qqq applications with Redis and in-memory support.

    View Full Documentation

    More Cache Layer Articles

    Powered by qqq