51 lines
2.9 KiB
Markdown
51 lines
2.9 KiB
Markdown
---
|
||
name: session-20260621-1
|
||
description: 2026-06-21 第1次会话 — 接口性能排查 + sys_system.system_code 加索引
|
||
metadata:
|
||
type: session
|
||
date: 2026-06-21
|
||
sessionNumber: 1
|
||
startTime: 2026-06-21T00:00:00+08:00
|
||
---
|
||
|
||
# 2026-06-21 第1次会话
|
||
|
||
## 会话摘要
|
||
用户反馈两个接口响应慢，排查了全链路耗时分布。最终在 QA/Prod 数据库 `sys_system` 表 `system_code` 列加了普通索引。
|
||
|
||
## 关键操作
|
||
|
||
### /zgapi/v1/auth/system/list 性能排查
|
||
- **做了什么**: 完整追踪请求链路：Nginx → Gateway(9000) → TokenAuthFilter → RateLimitFilter → HeaderInjectFilter → ApiPermissionFilter → GatewayController → [HTTP转发] → Auth(9001) → DB/Redis
|
||
- **发现的浪费**:
|
||
1. JWT 签名验证执行了 3 次（TokenAuthFilter + RateLimitFilter + AuthServiceImpl）
|
||
2. 同一个 Redis key 被查询了 4 次（TokenAuthFilter GET+GETEXPIRE + AuthServiceImpl GET+GETEXPIRE）
|
||
3. Gateway→Auth HTTP 转发无连接池（SimpleClientHttpRequestFactory）
|
||
- **原因**: Gateway 和 Auth 服务各自独立认证，互不复用结果
|
||
- **结论**: 架构设计上的"层层设防"必然代价，不是 bug。未改代码
|
||
|
||
### /zgapi/v1/open/token 性能排查
|
||
- **做了什么**: 追踪 `/zgapi/v1/open/token` 全链路
|
||
- **发现的问题**:
|
||
1. `sys_system.system_code` 列没有索引 → 每次查询都是全表扫描
|
||
2. `sys_open_token_log` 用 UUID 主键，日志量上去后 INSERT 引发页分裂
|
||
3. RateLimitFilter 对所有 /open/token 请求共用一个 anonymous 限流 key
|
||
4. 同上：Gateway→Admin HTTP 转发无连接池
|
||
|
||
### sys_system.system_code 加索引
|
||
- **做了什么**: 在 QA (`mokeegatewayqa`) 和 Prod (`mokeegateway`) 的 `sys_system` 表 `system_code` 列创建普通索引 `idx_system_code`
|
||
- **SQL**: `CREATE INDEX idx_system_code ON sys_system (system_code)`
|
||
- **原因**: DDL 仅指定了 PRIMARY KEY (id)，system_code 的索引被遗漏，所有按 system_code 查询的场景都在全表扫描（/open/token、ApiPermissionFilter、GatewayController 业务系统转发等）
|
||
- **验证结果**: QA 和 Prod 均已确认 `idx_system_code` 存在
|
||
|
||
## 重要信息
|
||
- QA MySQL: db1.qa.zgitm.com / mokeegatewayqa
|
||
- Prod MySQL: db1.prod.zgitm.com / mokeegateway
|
||
- DDL `sys_system` 注释 "uk_system_code/uk_gateway_url 唯一性由应用层代码校验" 说明当时故意没建唯一约束，但普通索引也没有是遗漏
|
||
|
||
## 待处理
|
||
- [ ] 可以考虑给 `sys_system.gateway_url` 也加个索引（但使用频率低，优先级不高）
|
||
- [ ] `RestTemplateConfig` 改用连接池（HttpComponentsClientHttpRequestFactory），省掉每次转发的 TCP 握手
|
||
- [ ] `RateLimitFilter` 可以跳过 `/zgapi/v1/open/token`（获取 token 本身不应限流，且 anonymous key 是热点）
|
||
- [ ] Auth 服务 getTokenInfoFromRedis 中 JWT validateToken 可以改为只解析 payload 不验签（Gateway 已验证过）
|