# 搜索API对接指南-10-接口级压测脚本

原文第 10 章：压测脚本与用例。

## 10. 接口级压测脚本

仓库提供统一压测脚本：`scripts/perf_api_benchmark.py`，用于对以下接口做并发压测：

- 后端搜索：`POST /search/`
- 搜索建议：`GET /search/suggestions`
- 向量服务：`POST /embed/text`
- 翻译服务：`POST /translate`
- 重排服务：`POST /rerank`

说明：脚本对 `embed_text` 场景会校验返回向量内容有效性（必须是有限数值，不允许 `null/NaN/Inf`），不是只看 HTTP 200。

### 10.1 快速示例

```bash
# suggest 压测（tenant 162）
python scripts/perf_api_benchmark.py \
  --scenario backend_suggest \
  --tenant-id 162 \
  --duration 30 \
  --concurrency 50

# search 压测
python scripts/perf_api_benchmark.py \
  --scenario backend_search \
  --tenant-id 162 \
  --duration 30 \
  --concurrency 20

# 全链路压测（search + suggest + embedding + translate + rerank）
python scripts/perf_api_benchmark.py \
  --scenario all \
  --tenant-id 162 \
  --duration 60 \
  --concurrency 30 \
  --output perf_reports/all.json
```

### 10.2 自定义用例

可通过 `--cases-file` 覆盖默认请求模板。示例文件：

```bash
scripts/perf_cases.json.example
```

执行示例：

```bash
python scripts/perf_api_benchmark.py \
  --scenario all \
  --tenant-id 162 \
  --cases-file scripts/perf_cases.json.example \
  --duration 60 \
  --concurrency 40
```