Commit Message Generator MCP 工具关键问题修复总结
概述
本文档记录了 Commit Message Generator MCP 工具中两个关键问题的修复过程:API Key 过期时间判断错误和浏览器会话管理异常。这两个问题导致工具在判断 API Key 状态和续期流程中出现异常行为。
问题一:API Key 过期时间判断错误
问题描述
数据库返回的过期时间为 2025-12-23 00:00:00,表示 API Key 在 2025-12-23 的 00:00:00 就过期了。但工具错误地判断为"未过期",导致在 API Key 实际已过期的情况下仍然尝试使用,最终导致调用失败。
问题原因
- 时间格式解析错误:在
queryApiKeyFromRemote方法中,如果过期时间包含T,代码只取日期部分,丢失了时间信息。 - 过期时间计算错误:在
needsRefreshAsync和needsRefreshSync方法中,错误地使用T23:59:59作为过期时间,导致过期时间被延后一天。
错误代码示例:
// 错误:只取日期部分,丢失时间信息
if (expiryDate && expiryDate.includes('T')) {
expiryDate = expiryDate.split('T')[0];
}
// 错误:使用 T23:59:59,导致过期时间延后一天
const expiryDateTime = new Date(queryResult.expiryDate + 'T23:59:59');
修复方案
1. 修复 queryApiKeyFromRemote 方法
- 保留完整时间信息:正确处理数据库返回的时间格式
2025-12-23 00:00:00→ 转换为2025-12-23T00:00:002025-12-23T00:00:00→ 保持不变2025-12-23→ 转换为2025-12-23T00:00:00(表示在当天 00:00:00 过期)
- 缓存完整时间:在缓存中保存完整的时间信息,而不是只保存日期
2. 修复 needsRefreshAsync 方法
- 正确解析过期时间:
- 如果只有日期部分,使用
T00:00:00(表示在当天 00:00:00 过期) - 正确处理空格分隔的时间格式
- 添加日期有效性检查
- 如果只有日期部分,使用
- 准确计算剩余时间:使用正确的过期时间计算剩余小时数
3. 修复 needsRefreshSync 方法
- 应用相同的时间解析逻辑,确保同步和异步方法的一致性
4. 修复 updateApiKeyToRemote 和 updateCache 方法
- 在更新缓存时,统一将日期格式转换为完整时间格式
修复效果
修复后,如果数据库返回 2025-12-23 00:00:00:
- 修复前:被错误解析为
2025-12-23T23:59:59,认为在 23:59:59 才过期 - 修复后:正确解析为
2025-12-23T00:00:00,正确识别为在 00:00:00 就过期
问题二:浏览器会话管理异常
问题描述
用户输入验证码后,系统检查发现 API Key 状态正常,无需续期。但用户再次使用 MCP 工具时,却提示"API Key 续期失败",并出现浏览器会话异常错误("Session closed" 或 "Attempted to use detached Frame")。
问题原因
状态检查时机错误:在
handleRenewApiKey中,当forceRenew=true时,跳过了状态检查,直接启动浏览器。即使用户已经通过验证码确认 API Key 状态正常,再次调用时仍会触发续期流程。浏览器会话未正确清理:
- 当检查到不需要续期时,直接返回成功,但浏览器可能已经启动,没有关闭
- 验证码验证失败时,浏览器会话未正确清理
- 异常情况下,浏览器会话未正确清理
续期结果处理逻辑不完善:在
handleGenerateCommitMessageAuto中,如果续期返回成功但实际上是"无需续期"的情况,没有正确区分,导致继续走续期失败的逻辑。
修复方案
1. 修复 handleRenewApiKey 方法
强制续期模式也检查状态:即使
forceRenew=true,也先检查 API Key 状态- 如果不需要续期,直接返回成功并关闭浏览器
- 避免不必要的浏览器操作
验证码输入后再次检查:在验证验证码之前,再次检查是否需要续期
- 如果在上次发送验证码后,API Key 已经被其他方式续期了,直接返回成功
- 关闭可能已启动的浏览器
完善异常处理:在所有可能提前返回或出错的分支中,确保关闭浏览器
2. 修复 handleGenerateCommitMessageAuto 方法
- 正确区分续期结果:
- 如果续期返回成功且
phase === 'completed'且消息包含"无需续期",说明 API Key 状态正常 - 直接使用缓存的 API Key,继续生成提交信息,不再走续期流程
- 如果是真正的续期成功,刷新 API Key 后继续
- 如果续期返回成功且
修复后的完整流程
- 用户调用
generateCommitMessageAuto - 检查 API Key 状态
- 如果需要续期:
- 调用
handleRenewApiKey({ forceRenew: true }) - 在
handleRenewApiKey中再次检查状态 - 如果不需要续期,直接返回成功(不会启动浏览器)
- 如果需要续期,启动浏览器发送验证码
- 调用
- 用户输入验证码后:
- 再次检查状态
- 如果不需要续期,返回成功并关闭浏览器
- 如果需要续期,继续完成登录和重置流程
- 回到
generateCommitMessageAuto:- 如果续期返回成功且是"无需续期",直接使用缓存的 API Key 继续生成提交信息
- 如果是真正的续期成功,刷新 API Key 后继续生成提交信息
修复效果
- 修复前:即使确认 API Key 状态正常,仍可能触发续期流程,导致浏览器会话异常
- 修复后:如果确认 API Key 状态正常,直接使用它生成提交信息,不会再走到续期失败的逻辑,浏览器会话得到正确管理
技术要点总结
时间处理最佳实践
- 统一时间格式:在内部统一使用 ISO 8601 格式(
yyyy-mm-ddTHH:mm:ss) - 明确过期时间含义:数据库返回的
2025-12-23 00:00:00表示在 00:00:00 就过期,而不是在 23:59:59 才过期 - 完整保存时间信息:在缓存中保存完整的时间信息,避免丢失精度
浏览器会话管理最佳实践
- 状态检查优先:在执行任何浏览器操作之前,先检查是否真的需要执行
- 及时清理资源:在所有可能提前返回或出错的分支中,确保关闭浏览器
- 区分不同场景:正确区分"无需续期"和"续期成功"两种不同的成功场景
相关文件
src/apiKeyManager.ts:API Key 管理逻辑,包含时间判断修复src/index.ts:MCP 服务器主逻辑,包含浏览器会话管理修复
版本信息
- 修复版本:v1.7.2
- 修复日期:2025-12-23