# org.apache.kafka.common.errors.GroupJoinTimeoutException: Join group request timed out

- **ID:** `kafka/group-join-timeout`
- **Domain:** kafka
- **Category:** runtime_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

Consumer failed to join the consumer group within the configured session timeout or max.poll.interval.ms.

## Workarounds

1. **Increase max.poll.interval.ms to allow more time between polls, e.g., props.put("max.poll.interval.ms", "600000");** (80% success)
   ```
   Increase max.poll.interval.ms to allow more time between polls, e.g., props.put("max.poll.interval.ms", "600000");
   ```
2. **Reduce max.poll.records to process fewer records per poll, e.g., props.put("max.poll.records", "100");** (75% success)
   ```
   Reduce max.poll.records to process fewer records per poll, e.g., props.put("max.poll.records", "100");
   ```
3. **Use a separate thread for processing and call consumer.commitAsync() more frequently.** (85% success)
   ```
   Use a separate thread for processing and call consumer.commitAsync() more frequently.
   ```

## Dead Ends

- **** — Increasing session.timeout.ms alone doesn't fix slow processing; it only delays the timeout. (85% fail)
- **** — Restarting the consumer doesn't resolve the underlying cause of slow processing or network issues. (90% fail)