# pytest.PytestConfigWarning: Unknown config option: timeout
E   Failed: Timeout >300.0s

- **ID:** `python/pytest-timeout-plugin-error`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

`timeout` in pytest config requires the `pytest-timeout` plugin. Without it, the option is ignored, or with it, the test genuinely exceeded the limit.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 2.x | active | — | — |

## Workarounds

1. **** (92% success)
   ```
   pip install pytest-timeout, then configure:
[tool.pytest.ini_options]
timeout = 60
timeout_method = "thread"
   ```
2. **** (85% success)
   ```
   Investigate the slow test with `pytest --durations=10` to identify the bottleneck before raising the limit.
   ```

## Dead Ends

- **** — Long-running tests can hang CI indefinitely. (60% fail)
- **** — Disables the timeout entirely, defeating the purpose. (70% fail)