fix(FEAT-DS-001): 修正MySQL健康检查会话时区

2026-08-24 22:42:21 +08:00
parent a10c785ff8
commit 9ff6646d56
9 changed files with 141 additions and 76 deletions
@@ -10,11 +10,11 @@

 ## 发现

-已完成实现 Review：未发现阻断项。Client 只允许三个固定 AKTools 路径，Service 用 `Promise.allSettled` 做模块级降级，DTO 不透传中文原始字段；Web 只通过 Axios API 文件访问 Nest。发现页面接线遗漏 `shortTermConclusion` 未解构，已在测试失败后修复。
+已完成实现 Review：未发现阻断项。Client 只允许三个固定 AKTools 路径，Service 用 `Promise.allSettled` 做模块级降级，DTO 不透传中文原始字段；Web 只通过 Axios API 文件访问 Nest。发现页面接线遗漏 `shortTermConclusion` 未解构，已在测试失败后修复。后续健康检查复核发现 `mysql2` 的 `timezone` 选项不会改变服务端会话变量，已在同一连接上显式设置 `+08:00` 并用 `finally` 释放；成功顺序和查询失败释放均有回归测试。

 ## 测试缺口

-上游 5xx、超时、部分接口失败、字段非法、响应大小、不可用状态和窄屏布局已有定向覆盖；交易日期延迟口径和 AKShare 字段漂移仍需后续真实交易日联调。
+上游 5xx、超时、部分接口失败、字段非法、响应大小、不可用状态、MySQL 会话时区/释放和窄屏布局已有定向覆盖；交易日期延迟口径和 AKShare 字段漂移仍需后续真实交易日联调。

 ## 安全与残余风险

@@ -22,7 +22,7 @@

 ## 性能与资源影响

-三个请求并行，10 秒超时，2 MiB 响应上限，不引入缓存和消息链路；测试证据仅证明行为和边界，不构成生产容量证明。
+三个请求并行，10 秒超时，2 MiB 响应上限；MySQL 健康检查复用单个连接完成会话设置和元数据查询，并在成功或异常路径释放连接；不引入缓存和消息链路，测试证据仅证明行为和边界，不构成生产容量证明。

 ## GitNexus 与同步修改

@@ -30,7 +30,7 @@

 ## 修复与复审

-发现问题后记录修复提交和复审证据。
+发现问题后记录修复提交和复审证据；本轮健康检查修复通过 80 项后端测试、全量门禁和真实 `/api/v1/health` HTTP 200 验证。

 ## 最终结论

@@ -6,7 +6,7 @@

 ## 不符合项与处置

-逐项检查通过：功能档案、中文注释、OpenAPI 生成契约、Axios API 边界、固定数据源 Adapter、模块级降级、环境模板和未提交凭据约束均符合规范。实现期间发现的页面接线遗漏已修复并由前端全量测试复验。
+逐项检查通过：功能档案、中文注释、OpenAPI 生成契约、Axios API 边界、固定数据源 Adapter、模块级降级、环境模板和未提交凭据约束均符合规范。实现期间发现的页面接线遗漏已修复并由前端全量测试复验；MySQL 健康检查的服务端时区误判已通过显式会话设置、连接释放 finally 和回归测试修复。

 ## 安全、性能与架构检查

@@ -14,7 +14,7 @@

 ## GitNexus 与开发总结检查

-开发前后 GitNexus 报告、影响计划、变更检测、开发总结、测试结果、视觉 QA、Review 和回退说明均已补齐；`governance:finish` 及最终提交前再次执行变更检测。
+开发前后 GitNexus 报告、影响计划、变更检测、开发总结、测试结果、视觉 QA、Review 和回退说明均已补齐；本轮修复的 GitNexus 影响分析为 LOW，仅影响健康客户端和 API 工厂直接调用；`governance:finish` 及最终提交前再次执行变更检测。

 ## 最终结论