# 压力测试工具 - Cbcs Statistics

## 📋 项目简介

这是一个基于 **Locust** 的压力测试工具，专门用于对车辆统计信息接口进行性能测试。该工具支持 OAuth2 认证和客户端证书认证，可以模拟多用户并发访问 `/api/vehicles/{vin}/statistics` 接口。

## ✨ 主要功能

- 🔐 **OAuth2 Client Credentials 认证**：自动获取 Access Token
- 📜 **客户端证书认证**：支持 PFX 格式的客户端证书
- 🚗 **多 VIN 码支持**：支持 GEN5 和 GEN6 两种车型测试
- 📊 **压力测试报告**：提供详细的性能指标和测试报告
- ⚙️ **灵活配置**：支持通过代码或命令行参数配置测试参数

## 🛠️ 技术栈

- **Python 3.x**
- **Locust**：分布式压力测试框架
- **cryptography**：处理 PFX 证书文件
- **urllib3**：HTTP 请求库

## 📦 安装依赖

```bash
pip install locust cryptography urllib3
```

## ⚙️ 配置说明

在运行测试之前，请根据实际环境修改 `cbcs_statics.py` 中的配置项：

### 1. OAuth2 认证配置

```python
AUTH_URL = "https://ssoalpha.dvb.corpinter.net.cn/v1/token"  # Token 获取地址
CLIENT_ID = "D650DB94-FB62-427A-980A-601BBC3081B6"          # 客户端 ID
CLIENT_SECRET = "wU2G-xa08SHY_T7N.5BcFv~M94q61D3n"           # 客户端密钥
SCOPE = "openid"                                              # 授权范围
```

### 2. 业务接口配置

```python
GEN6_TEST_VIN = "LE4FG1DB1SL002567"  # GEN6 测试 VIN 码
GEN5_TEST_VIN = "LE4AG4CB7SLYTKXLG"  # GEN5 测试 VIN 码
API_PATH = "/api/vehicles/{vin}/statistics"  # 业务接口路径
Baumuster = "174123"                        # 业务标识
```

### 3. 客户端证书配置

```python
key_store_file_path = "mic_certificate_W1AFJ10000Z000085.pfx"  # PFX 证书文件路径
key_store_passphrase = "b04ca3c0-518d-40b0-a0d5-01c0c25350b9"  # 证书密码
```

## 🚀 使用方法

### 基本用法

启动 Locust Web 界面：

```bash
locust -f cbcs_statics.py
```

然后在浏览器中打开 `http://localhost:8089`，设置以下参数：
- **Number of users**：并发用户数
- **Spawn rate**：每秒启动的用户数
- **Host**：目标服务器地址（例如：`https://your-api-domain.com`）

### 无头模式（Headless）

直接在命令行运行压力测试：

```bash
locust -f cbcs_statics.py --headless -u 100 -r 10 -t 5m --host https://your-api-domain.com
```

参数说明：
- `-u 100`：100 个并发用户
- `-r 10`：每秒启动 10 个用户
- `-t 5m`：测试持续 5 分钟
- `--host`：目标服务器地址

### 指定配置文件

如果需要从配置文件加载参数：

```bash
locust -f cbcs_statics.py --config locust.conf
```

## 📊 测试指标

Locust 会提供以下关键性能指标：

- **RPS (Requests Per Second)**：每秒请求数
- **Response Time**：响应时间（平均、中位数、最小值、最大值）
- **Failure Rate**：失败率
- **Peak RPS**：峰值请求数

## 🏷️ 标签过滤

测试任务使用了 `@tag('business_api')` 标签，可以通过以下方式只运行特定标签的测试：

```bash
locust -f cbcs_statics.py --tags business_api
```

## 📁 项目结构

```
pressure_test/
├── cbcs_statics.py              # 主测试脚本
├── mic_certificate_*.pfx        # 客户端证书文件（需要自行提供）
└── README.md                    # 项目说明文档
```

## ⚠️ 注意事项

1. **证书文件**：确保 PFX 证书文件存在于项目目录中，并且路径配置正确
2. **SSL 验证**：项目已禁用 SSL 验证（`verify=False`），适用于企业内网环境
3. **Token 复用**：所有虚拟用户共享同一个 Access Token，避免频繁请求认证接口
4. **安全提醒**：请勿将包含敏感信息（如 CLIENT_SECRET、证书密码）的代码提交到公共仓库
5. **网络环境**：确保测试机器能够访问目标服务器和认证服务器

## 🔧 常见问题

### Q: 如何切换测试的 VIN 码？

修改 `WebsiteUser` 类中的 `vin` 属性：

```python
class WebsiteUser(HttpUser):
    vin = GEN5_TEST_VIN  # 或 GEN6_TEST_VIN
```

### Q: 如何调整用户请求间隔？

修改 `wait_time` 配置：

```python
wait_time = between(1, 3)  # 1-3 秒随机等待时间
```

### Q: 获取 Token 失败怎么办？

检查以下配置：
- `AUTH_URL` 是否正确
- `CLIENT_ID` 和 `CLIENT_SECRET` 是否有效
- 网络连接是否正常
- 查看控制台输出的错误信息

## 📝 许可证

本项目仅供内部测试使用。

## 👥 贡献

如有问题或建议，请联系项目维护者。