# fastapi.exceptions.RequestValidationError: 422 Unprocessable Entity - file field required

- **ID:** `python/fastapi-upload-file-error`
- **Domain:** python
- **Category:** data_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

上传文件请求缺少必需的 file 字段，或格式不正确。

## Version Compatibility

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

## Workarounds

1. **** (95% success)
   ```
   确保客户端使用 multipart/form-data 并包含正确字段名。
   ```
2. **** (90% success)
   ```
   使用 UploadFile 类型并指定 File(...) 作为必需参数。
   ```
3. **** (85% success)
   ```
   添加异常处理器返回更清晰的错误信息。
   ```

## Dead Ends

- **** — 客户端发送 JSON 而不是 multipart/form-data。 (80% fail)
- **** — 字段名错误，如使用 'files' 而不是 'file'。 (70% fail)
- **** — 忽略错误，不检查上传格式。 (60% fail)