初始化

memory/session-20260621-1.md

@@ -0,0 +1,50 @@
+---
+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 已验证过）