# 分区未找到异常：此服务器不托管该分区

- **ID:** `kafka/partition-not-found`
- **领域:** kafka
- **类别:** runtime_error
- **验证级别:** ai_generated
- **修复率:** 78%

## 根因

客户端请求的目标分区不在该代理上托管，通常由于元数据过时或分区重新分配。

## 解决方案

1. ```
   通过设置 metadata.max.age.ms 为较低值强制刷新元数据，例如 props.put("metadata.max.age.ms", "5000");
   ```
2. ```
   等待分区重新分配完成并检查状态：kafka-reassign-partitions.sh --bootstrap-server localhost:9092 --verify --reassignment-json-file reassign.json
   ```
3. ```
   重启客户端以强制从代理获取新的元数据。
   ```

## 无效尝试

- **** — Manually deleting the partition metadata can lead to data loss and inconsistency. (95% 失败率)
- **** — Ignoring the error and retrying without refreshing metadata will keep failing. (90% 失败率)