294 lines
12 KiB
Markdown
294 lines
12 KiB
Markdown
# 游戏性能与 QPS 分析（Dice 项目）
|
||
|
||
> 本文基于当前骰子游戏（dice）项目的实际代码结构，对后端接口的性能瓶颈、QPS 能力和优化方向做说明，便于后续压测、扩容和排查问题。
|
||
|
||
---
|
||
|
||
## 1. 运行环境与架构概览
|
||
|
||
| 项目 | 说明 |
|
||
|----------------|----------------------------------------------------------------------|
|
||
| 应用框架 | Webman（基于 Workerman 的常驻内存 PHP 框架） |
|
||
| 业务模块 | `app/dice`（玩家、抽奖记录、奖励配置、奖池配置、看板等） |
|
||
| HTTP 监听地址 | 通常为 `http://0.0.0.0:6688` |
|
||
| Worker 数量 | 推荐：`cpu_count() * 4`（例如 8 核 CPU → 32 个 Worker 进程） |
|
||
| 数据库 | MySQL + ThinkORM，使用连接池（例如 max=20 / min=2） |
|
||
| 缓存 | Redis + think-cache，使用连接池（例如 max=20 / min=2） |
|
||
|
||
**生产环境配置建议：**
|
||
|
||
- 在 `.env` 中统一使用 Redis 作为默认缓存：`CACHE_MODE=redis`
|
||
- 调整 `DB_POOL_MAX` / `REDIS_POOL_MAX`，使其与 Worker 数量和 MySQL `max_connections` 匹配
|
||
|
||
---
|
||
|
||
## 2. 核心接口与负载特征
|
||
|
||
从当前项目代码来看，游戏相关接口大致可以分为三类：
|
||
|
||
- **高负载型**：强依赖 DB + Redis，多次写入或复杂逻辑（QPS 瓶颈主要在这里）
|
||
- **中负载型**：部分写 DB 或复杂读 DB
|
||
- **轻量型**：读缓存或简单 DB 查询
|
||
|
||
### 2.1 主要接口梳理
|
||
|
||
| 接口 | 用途 | 负载级别 | 说明 / 风险点 |
|
||
|-------------------------------------|--------------------|----------|--------------------------------------------------------|
|
||
| `POST /api/game/playStart` | 开始一局游戏 / 抽奖 | 高 | 多次 DB + Redis 操作，是整体 QPS 的核心瓶颈 |
|
||
| `POST /api/game/buyLotteryTickets` | 购买门票 / 次数 | 中-高 | 多表写入：门票记录、钱包记录等 |
|
||
| `GET /api/game/config` | 获取游戏配置 | 中 | 依赖 `DiceConfig`，若无缓存会有全表扫描风险 |
|
||
| `GET /api/game/lotteryPool` | 获取奖池 / 奖励配置 | 中 | 依赖 `DiceLotteryPoolConfig` / `DiceRewardConfig` |
|
||
| `POST /api/v1/getGameUrl` | 获取游戏 URL | 中 | JWT + Redis 鉴权，DB 较少，Redis 压力较大 |
|
||
| `POST /api/v1/getPlayerInfo` | 获取玩家信息 | 中 | 需要 `dice_player.username` 索引，否则易产生慢查询 |
|
||
| `POST /api/v1/getPlayerGameRecord` | 获取玩家历史记录 | 中-高 | 若未优化，容易出现 N+1 查询问题 |
|
||
| `POST /api/v1/setPlayerWallet` | 调整玩家钱包余额 | 中 | 涉及余额变更与流水写入，需处理好并发与幂等 |
|
||
|
||
在进行 QPS 能力评估或性能优化时，优先关注：
|
||
|
||
- `playStart` 接口；
|
||
- 门票 / 钱包 / 流水相关接口。
|
||
|
||
---
|
||
|
||
## 3. `playStart` 调用链与资源消耗
|
||
|
||
以下是典型的一次 `playStart` 请求在后端的大致流程（抽象描述）：
|
||
|
||
### 3.1 数据库访问路径（典型情况）
|
||
|
||
1. **加载玩家信息**
|
||
- 调用 `DicePlayer::find($playerId)`
|
||
- 建议：每个请求只查询一次，并在后续逻辑中复用该对象。
|
||
|
||
2. **加载奖励 EV / 最小实际 EV**
|
||
- 调用 `DiceRewardConfig::getCachedMinRealEv()`
|
||
- 首次会访问 DB 并写入 Redis；后续命中 Redis 即可。
|
||
|
||
3. **获取或创建奖池（LotteryService）**
|
||
- 调用 `LotteryService::getOrCreate()`：
|
||
- 优先从 Redis 中读取奖池信息；
|
||
- 若缓存不存在，则从 DB 中加载：如 `DiceLotteryPoolConfig::where('name','default/killScore')->find()`。
|
||
|
||
4. **根据本次玩法加载奖池配置**
|
||
- 调用 `DiceLotteryPoolConfig::find($configId)`。
|
||
|
||
5. **核心业务落库（可能在事务中执行）**
|
||
- `DicePlayRecord::create()`：写入本次抽奖记录；
|
||
- `DicePlayer::save()`：更新玩家余额、状态等；
|
||
- `DicePlayerTicketRecord::create()`：写入门票/次数流水；
|
||
- `DiceLotteryPoolConfig::where('id')->update(['ev' => Db::raw(...)]`：更新 EV 统计；
|
||
- `DicePlayerWalletRecord::create()`：写入钱包流水。
|
||
|
||
6. **刷新玩家缓存**
|
||
- 再次使用（或重新加载）玩家信息，调用 `UserCache::setUser($player)` 同步到 Redis。
|
||
|
||
**DB / Redis 调用次数粗略估算：**
|
||
|
||
- 在写法合理、缓存命中良好的情况下，每次 `playStart` 大致会产生：
|
||
- 3 ~ 6 次 DB 访问（读 + 写）；
|
||
- 3 ~ 6 次 Redis 操作。
|
||
- 若在同一请求中多次重复调用 `DicePlayer::find($playerId)`，DB 调用次数和耗时都会显著上升。
|
||
|
||
### 3.2 Redis 使用路径
|
||
|
||
在当前设计中，Redis 主要用于：
|
||
|
||
- 奖励 / 奖池配置缓存：`DiceRewardConfig::getCachedInstance()`、`getCachedByTier()`、`LotteryService::getOrCreate()` 等；
|
||
- 玩家缓存：`UserCache::getUser()`、`UserCache::setUser()`；
|
||
- 统计计数：可以使用 Redis `INCRBY` 等命令维护 EV 或其他统计数据。
|
||
|
||
**目标：** 热路径尽量命中 Redis，DB 主要负责落库和冷数据读取。
|
||
|
||
---
|
||
|
||
## 4. 性能瓶颈与优化方向
|
||
|
||
### 4.1 数据库连接与 SQL
|
||
|
||
1. **连接池大小**
|
||
- 在 32 个 Worker 且 `DB_POOL_MAX=20` 的情况下，高并发时容易出现连接耗尽和等待。
|
||
- 建议：根据 CPU 核心数和目标 QPS，将 `DB_POOL_MAX` 调整到 **32 ~ 64** 左右，并保证 MySQL `max_connections` 足够大。
|
||
|
||
2. **避免重复查询**
|
||
- 在 `playStart` 中，玩家信息应只查询一次：`$player = DicePlayer::find($playerId)`，后续逻辑统一使用 `$player`，避免重复 `find`。
|
||
|
||
3. **EV 更新策略**
|
||
- 频繁在在线请求中执行 `UPDATE dice_lottery_pool_config SET ev = ev - ?`，会造成该行热点锁竞争；
|
||
- 建议：
|
||
- 在线请求仅将 EV 变动累加到 Redis 计数器；
|
||
- 通过定时任务批量同步 Redis 中的统计数据回 MySQL。
|
||
|
||
4. **索引覆盖**
|
||
- 高频查询条件（如 `username`、`player_id`、`create_time`、`status` 等）必须有合适索引（见第 6 节）。
|
||
|
||
### 4.2 缓存与序列化开销
|
||
|
||
1. **统一使用 Redis 缓存驱动**
|
||
- `.env` 中设置：`CACHE_MODE=redis`；
|
||
- `config/cache.php` 中，生产环境默认缓存驱动应为 Redis。
|
||
|
||
2. **UserCache 加解密成本**
|
||
- 若 `UserCache` 中对玩家信息做 AES 加解密，在高 QPS 场景下会占用较多 CPU；
|
||
- 可以：
|
||
- 精简缓存字段，只缓存必要信息；
|
||
- 控制 `setUser` 调用频率，避免无意义重复写入；
|
||
- 评估哪些字段确实需要加密，非敏感字段可不加密。
|
||
|
||
### 4.3 N+1 查询问题
|
||
|
||
历史记录、钱包流水等接口非常容易出现 N+1 查询，例如：
|
||
|
||
- 循环按玩家逐条查询记录；
|
||
- 循环对每条记录再单独查询玩家信息。
|
||
|
||
建议：
|
||
|
||
- 使用 `whereIn('player_id', $playerIds)` 做批量查询；
|
||
- 使用 `with(['dicePlayer'])` 或 join 预加载关联的玩家信息；
|
||
- 控制单页 `limit`，例如不超过 100 条。
|
||
|
||
### 4.4 Redis 与 DB 的整体协同
|
||
|
||
- Worker 数、DB 连接池、Redis 连接池三者要相互匹配：
|
||
- 出现 CPU 未打满但 DB/Redis 已经“顶满”的情况，多半是配置不平衡。
|
||
- 对 Redis 的监控要关注：
|
||
- 慢日志（慢命令）；
|
||
- 大 Key 或热点 Key（必要时做拆分或分桶）。
|
||
|
||
---
|
||
|
||
## 5. 单机 QPS 能力（估算）
|
||
|
||
> 以下为在常见生产环境（如 8C32G 单机、MySQL/Redis 与应用在同一内网）且做好上述优化后的大致量级，仅用于评估和对比，实际仍需通过压测确认。
|
||
|
||
### 5.1 单接口预估
|
||
|
||
- `playStart`
|
||
- 单次耗时：约 50 ~ 150 ms（受 DB/Redis 延迟和业务分支影响）；
|
||
- 单机 QPS：约 **200 ~ 300**。
|
||
|
||
- `buyLotteryTickets`
|
||
- 单次耗时：约 20 ~ 60 ms；
|
||
- 单机 QPS：约 **500 ~ 1000+**。
|
||
|
||
- `getGameUrl` / 登录类接口
|
||
- 单次耗时：约 30 ~ 80 ms；
|
||
- 单机 QPS：约 **400 ~ 800**。
|
||
|
||
### 5.2 混合业务场景
|
||
|
||
假设：
|
||
|
||
- 70% 请求是 `playStart`；
|
||
- 30% 请求为 `getGameUrl`、`getPlayerInfo` 等轻 / 中量接口；
|
||
|
||
在 8 核 32 Worker、索引和缓存配置合理的前提下：
|
||
|
||
- 单机综合 QPS 约可达到 **250 ~ 400 QPS**；
|
||
- 若需要显著更高的整体 QPS，应采用多节点水平扩展 + DB/Redis 扩容（读写分离、分库分表等）。
|
||
|
||
---
|
||
|
||
## 6. 索引与表结构建议
|
||
|
||
### 6.1 必备索引
|
||
|
||
| 表名 | 索引 | 用途说明 |
|
||
|------------------------------|-----------------------------------|--------------------------------|
|
||
| `dice_player` | 唯一索引 `unique(username)` | 通过用户名快速定位玩家 |
|
||
| `dice_play_record` | 普通索引 `(player_id, create_time)` | 玩家历史记录分页 + 时间排序 |
|
||
| `dice_player_wallet_record` | 普通索引 `(player_id, create_time)` | 钱包流水查询 |
|
||
| `dice_player_ticket_record` | 普通索引 `(player_id, create_time)` | 门票流水查询 |
|
||
|
||
示例 SQL：
|
||
|
||
```sql
|
||
ALTER TABLE dice_player ADD UNIQUE INDEX uk_username (username);
|
||
ALTER TABLE dice_play_record ADD INDEX idx_player_create (player_id, create_time);
|
||
ALTER TABLE dice_player_wallet_record ADD INDEX idx_player_create (player_id, create_time);
|
||
ALTER TABLE dice_player_ticket_record ADD INDEX idx_player_create (player_id, create_time);
|
||
```
|
||
|
||
### 6.2 大表策略
|
||
|
||
对于体量较大的历史表（抽奖记录、钱包流水、门票流水等），建议提前规划：
|
||
|
||
- 分区或分表策略（按时间或按玩家 ID）；
|
||
- 归档 / 删除过旧数据，例如只保留最近 N 个月的在线查询。
|
||
|
||
---
|
||
|
||
## 7. 压测步骤与指标观测
|
||
|
||
### 7.1 压测 `playStart`
|
||
|
||
1. 准备数据：
|
||
- 预先创建足够多的测试玩家及初始余额；
|
||
- 获取一批可用的 JWT token。
|
||
|
||
2. 使用 `ab` 压测示例：
|
||
|
||
```bash
|
||
ab -n 2000 -c 32 \
|
||
-p post_body.json \
|
||
-T application/json \
|
||
-H "token: YOUR_JWT" \
|
||
http://127.0.0.1:6688/api/game/playStart
|
||
```
|
||
|
||
3. 使用 `wrk` 压测示例：
|
||
|
||
```bash
|
||
wrk -t4 -c32 -d60s -s play_start.lua http://127.0.0.1:6688/api/game/playStart
|
||
```
|
||
|
||
4. 重点关注指标：
|
||
- QPS（Requests per second）；
|
||
- P95 / P99 延迟；
|
||
- 错误率（HTTP 5xx、超时、业务失败）；
|
||
- MySQL / Redis 的 CPU 使用率与连接数。
|
||
|
||
### 7.2 常见问题排查思路
|
||
|
||
1. **QPS 上不去，CPU 却不高**
|
||
- 检查 DB / Redis 连接池是否经常“打满”；
|
||
- 是否存在慢 SQL（全表扫描、缺索引）；
|
||
- 是否有外部依赖（如第三方接口）拖慢整体。
|
||
|
||
2. **P99 延迟偶尔飙高**
|
||
- 查看是否有大事务 / 大批量更新与压测同时进行；
|
||
- 观察磁盘 I/O 和 GC 情况；
|
||
- 检查 Redis 是否有大 Key 或阻塞命令（如 `KEYS`）。
|
||
|
||
---
|
||
|
||
## 8. 配置与代码自查清单
|
||
|
||
> 建议在压测前和上线前都按此清单进行一次自查。
|
||
|
||
### 8.1 配置层面
|
||
|
||
- `.env`：
|
||
- [ ] `CACHE_MODE=redis` 已开启；
|
||
- [ ] `DB_POOL_MAX` / `DB_POOL_MIN` 已根据 CPU 与 MySQL `max_connections` 调整；
|
||
- [ ] `REDIS_POOL_MAX` 能够支撑预期并发量。
|
||
- MySQL：
|
||
- [ ] `max_connections` 不小于所有应用实例 DB 连接池上限之和；
|
||
- [ ] 已开启慢查询日志，并设置了合理阈值。
|
||
|
||
### 8.2 代码层面
|
||
|
||
- [ ] `playStart` 在一次请求中只加载一次玩家信息并全程复用；
|
||
- [ ] 奖励/奖池配置统一通过缓存访问，修改后有刷新缓存逻辑（如 `refreshCache()`）；
|
||
- [ ] 历史记录、钱包流水接口避免 N+1 查询，使用批量查询或预加载；
|
||
- [ ] EV 等高频统计字段不直接在在线请求中频繁 `UPDATE`，而是通过 Redis 聚合后批量回写。
|
||
|
||
---
|
||
|
||
## 9. 总结
|
||
|
||
1. 对于当前 dice 项目，`playStart` 以及与之相关的奖池、钱包、门票逻辑，是后端 QPS 能力的关键瓶颈所在。
|
||
2. 通过合理配置 DB/Redis 连接池、充分利用缓存、补齐必要索引、减少重复查询和热点 UPDATE，可以大幅提升单机可承载的 QPS，并降低 P99 延迟。
|
||
3. 真正的容量边界必须通过 `ab` / `wrk` / `k6` 等工具在接近真实数据和流量模型的情况下进行压测验证，本文档主要为定位瓶颈和指导优化提供一个工程实践层面的参考。
|
||
|