# org.mockito.exceptions.base.MockitoException: ArgumentCaptor's capture() method was never invoked

- **ID:** `java/mockito-argumentcaptor-not-invoked`
- **Domain:** java
- **Category:** runtime_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

ArgumentCaptor used without verifying that the method was actually called with the captured argument.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 8+ | active | — | — |

## Workarounds

1. **Use verify with captor** (95% success)
   ```
   ArgumentCaptor<String> captor = ArgumentCaptor.forClass(String.class);
verify(mock).method(captor.capture());
assertEquals("expected", captor.getValue());
   ```
2. **Use @Captor annotation** (90% success)
   ```
   @Captor
ArgumentCaptor<String> captor;

verify(mock).method(captor.capture());
   ```

## Dead Ends

- **Calling captor.getValue() without verify** — Capture only happens during verification, so value is null. (90% fail)
- **Using captor.capture() in when() instead of verify()** — capture() is for verification, not stubbing. (70% fail)