intermittent-issue-debugging

间歇性问题调试

目录

• 概述
• 适用场景
• 快速入门
• 参考指南
• 最佳实践

概述

间歇性问题最难调试，因为它们不会持续出现。采用系统化的方法并进行全面监控至关重要。

适用场景

• 日志中偶尔出现错误
• 用户报告偶发问题
• 不稳定的测试
• 怀疑存在竞态条件
• 依赖时序的 Bug
• 资源耗尽问题

快速入门

最简可运行示例：

// Strategy 1: Comprehensive Logging
// Add detailed logging around suspected code

function processPayment(orderId) {
  const startTime = Date.now();
  console.log(`[${startTime}] Payment start: order=${orderId}`);

  try {
    const result = chargeCard(orderId);
    console.log(`[${Date.now()}] Payment success: ${orderId}`);
    return result;
  } catch (error) {
    const duration = Date.now() - startTime;
    console.error(`[${Date.now()}] Payment FAILED:`, {
      order: orderId,
      error: error.message,
      duration_ms: duration,
      error_type: error.constructor.name,
      stack: error.stack,
    });
    throw error;
  }
}

// Strategy 2: Correlation IDs
// ... (see reference guides for full implementation)

参考指南

详细实现见 references/ 目录：

指南	内容
捕获间歇性问题	捕获间歇性问题
常见间歇性问题	常见间歇性问题
系统化调查流程	系统化调查流程
监控与预防	监控与预防

最佳实践

✅ 应该

• 遵循既定模式和规范
• 编写清晰、易于维护的代码
• 添加适当的文档
• 部署前进行全面测试

❌ 不应该

• 跳过测试或验证
• 忽视错误处理
• 将配置值硬编码