# ERR Consumer group 'mygroup' on stream 'mystream' claim timeout: no pending messages to claim

- **ID:** `redis/stream-consumer-group-claim-timeout`
- **Domain:** redis
- **Category:** runtime_error
- **Error Code:** `ERR`
- **Verification:** ai_generated
- **Fix Rate:** 85%

## Root Cause

XCLAIM command timed out because the consumer group has no pending messages that match the specified idle time or count.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| redis 7.0 | active | — | — |
| redis 7.2 | active | — | — |
| redis 6.2 | active | — | — |

## Workarounds

1. **Use XPENDING to check the pending message list before claiming, then adjust idle time or count accordingly:
XPENDING mystream mygroup** (85% success)
   ```
   Use XPENDING to check the pending message list before claiming, then adjust idle time or count accordingly:
XPENDING mystream mygroup
   ```
2. **Ensure consumers are actively processing messages to generate pending entries; if idle, use XREADGROUP with a valid consumer name.** (80% success)
   ```
   Ensure consumers are actively processing messages to generate pending entries; if idle, use XREADGROUP with a valid consumer name.
   ```

## Dead Ends

- **** — Timeout increase does not create pending messages; the root cause is lack of messages to claim. (60% fail)
- **** — Restarting resets group state but does not address the missing pending messages; messages may still be absent. (70% fail)
- **** — Deleting the stream removes all messages, making the claim even more impossible. (90% fail)