Debugging 실전 프로젝트 완벽 가이드

실전 프로젝트에서 마주치는 복잡한 버그를 효과적으로 해결하는 고급 디버깅 기법을 학습합니다. 로깅, 브레이크포인트, 성능 프로파일링부터 메모리 누수 탐지까지 다룹니다.

---

---

들어가며

이 글에서는 Debugging 실전 프로젝트 완벽 가이드에 대해 상세히 알아보겠습니다. 총 12가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. Stack_Trace_분석
2. Conditional_Breakpoint
3. Performance_Profiling
4. Memory_Leak_Detection
5. Source_Map_활용
6. Error_Boundary_패턴
7. Network_Request_디버깅
8. Async_Stack_Traces
9. Custom_Logger_구현
10. Proxy_기반_State_추적
11. Chrome_DevTools_Protocol
12. Regression_Testing_자동화

---

1. Stack Trace 분석

개요

에러 스택 트레이스를 분석하여 버그의 근본 원인을 빠르게 찾아내는 방법입니다.

코드 예제

function debugError(error) {
  console.error('Error:', error.message);
  console.error('Stack:', error.stack);
  const stackLines = error.stack.split('\n');
  const origin = stackLines[1].match(/\((.*):(\d+):(\d+)\)/);
  console.log(`발생 위치: ${origin[1]}, Line: ${origin[2]}`);
}

설명

스택 트레이스에서 정규식으로 파일 위치와 라인 번호를 추출하여 에러 발생 지점을 정확히 파악합니다.

---

2. Conditional Breakpoint

개요

특정 조건이 충족될 때만 실행을 멈춰 효율적으로 디버깅하는 조건부 브레이크포인트 기법입니다.

코드 예제

function processItems(items) {
  items.forEach((item, index) => {
    // 조건: item.id === 'problematic' 일 때만 중단
    if (item.id === 'problematic') {
      debugger; // 개발자 도구에서 여기서 멈춤
    }
    console.log(`Processing: ${item.name}`);
  });
}

설명

debugger 키워드와 조건문을 조합하여 문제가 되는 특정 데이터에서만 실행을 중단시켜 효율적으로 디버깅합니다.

---

3. Performance Profiling

개요

console.time/timeEnd로 코드 실행 시간을 측정하여 성능 병목 지점을 찾아냅니다.

코드 예제

async function analyzePerformance() {
  console.time('Database Query');
  await fetchFromDatabase();
  console.timeEnd('Database Query');

  console.time('Data Processing');
  processLargeDataset();
  console.timeEnd('Data Processing');
}

설명

각 작업의 실행 시간을 측정하여 어느 부분이 느린지 정량적으로 파악할 수 있습니다.

---

4. Memory Leak Detection

개요

WeakMap을 활용하여 메모리 누수를 방지하고 객체 참조를 안전하게 관리합니다.

코드 예제

const cache = new WeakMap();

function cacheUserData(user, data) {
  cache.set(user, data);
  // user 객체가 GC되면 자동으로 캐시도 제거됨
}

function getUserData(user) {
  return cache.get(user);
}

설명

WeakMap은 키 객체가 가비지 컬렉션되면 자동으로 엔트리를 제거하여 메모리 누수를 예방합니다.

---

5. Source Map 활용

개요

프로덕션 환경에서 압축된 코드의 원본 위치를 추적하여 디버깅합니다.

코드 예제

// webpack.config.js
module.exports = {
  mode: 'production',
  devtool: 'hidden-source-map',
  output: {
    filename: '[name].[contenthash].js',
    sourceMapFilename: 'maps/[file].map'
  }
};

설명

hidden-source-map을 사용하면 소스맵을 별도로 관리하여 보안을 유지하면서도 에러 추적이 가능합니다.

---

6. Error Boundary 패턴

개요

React에서 컴포넌트 트리의 에러를 포착하고 폴백 UI를 제공하는 방어적 프로그래밍 기법입니다.

코드 예제

class ErrorBoundary extends React.Component {
  state = { hasError: false, error: null };

  static getDerivedStateFromError(error) {
    return { hasError: true, error };
  }

  componentDidCatch(error, info) {
    console.error('Error caught:', error, info);
  }

  render() {
    if (this.state.hasError) return <FallbackUI />;
    return this.props.children;
  }
}

설명

하위 컴포넌트에서 발생한 에러를 상위에서 포착하여 앱 전체가 크래시되는 것을 방지합니다.

---

7. Network Request 디버깅

개요

fetch 요청을 인터셉트하여 요청/응답을 로깅하고 문제를 진단합니다.

코드 예제

const originalFetch = window.fetch;
window.fetch = async (...args) => {
  console.log('Request:', args);
  const response = await originalFetch(...args);
  const clone = response.clone();
  console.log('Response:', await clone.json());
  return response;
};

설명

fetch를 래핑하여 모든 네트워크 요청과 응답을 자동으로 로깅하여 API 통신 문제를 쉽게 파악합니다.

---

8. Async Stack Traces

개요

async/await에서 발생하는 에러의 전체 호출 스택을 추적합니다.

코드 예제

async function fetchUserData(userId) {
  try {
    const response = await fetch(`/api/users/${userId}`);
    const data = await response.json();
    return await processUser(data);
  } catch (error) {
    console.error('Async Error Chain:', error);
    throw new Error(`Failed at userId: ${userId}`, { cause: error });
  }
}

설명

try-catch로 비동기 에러를 포착하고 cause 옵션으로 원본 에러를 체이닝하여 전체 맥락을 유지합니다.

---

9. Custom Logger 구현

개요

환경별로 다른 로그 레벨을 적용하는 커스텀 로거로 디버깅 효율을 높입니다.

코드 예제

const logger = {
  levels: { debug: 0, info: 1, warn: 2, error: 3 },
  currentLevel: process.env.LOG_LEVEL || 'info',

  log(level, ...args) {
    if (this.levels[level] >= this.levels[this.currentLevel]) {
      console[level](`[${level.toUpperCase()}]`, ...args);
    }
  }
};

설명

환경 변수로 로그 레벨을 제어하여 개발/프로덕션 환경에서 적절한 양의 로그를 출력합니다.

---

10. Proxy 기반 State 추적

개요

Proxy 객체로 상태 변경을 감지하고 추적하여 예상치 못한 변경을 디버깅합니다.

코드 예제

function createTrackedState(target) {
  return new Proxy(target, {
    set(obj, prop, value) {
      console.log(`State changed: ${prop}`, {
        old: obj[prop], new: value
      });
      obj[prop] = value;
      return true;
    }
  });
}

설명

Proxy의 set 트랩으로 모든 속성 변경을 자동으로 로깅하여 상태 변화를 실시간으로 추적합니다.

---

11. Chrome DevTools Protocol

개요

Puppeteer로 브라우저를 원격 제어하며 자동화된 디버깅 시나리오를 실행합니다.

코드 예제

const puppeteer = require('puppeteer');

async function debugPagePerformance() {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();

  await page.coverage.startJSCoverage();
  await page.goto('https://example.com');
  const coverage = await page.coverage.stopJSCoverage();

  console.log('Unused JS:', coverage);
}

설명

Coverage API로 사용되지 않는 코드를 찾아내어 번들 크기를 최적화하고 성능을 개선합니다.

---

12. Regression Testing 자동화

개요

Jest 스냅샷 테스트로 의도하지 않은 코드 변경을 자동으로 감지합니다.

코드 예제

test('API response structure', async () => {
  const response = await fetchUserData(123);

  expect(response).toMatchSnapshot({
    id: expect.any(Number),
    createdAt: expect.any(String)
  });
});

설명

스냅샷 테스트로 API 응답 구조를 저장하고, 변경 시 자동으로 알림을 받아 회귀 버그를 조기에 발견합니다. --- 이 카드 뉴스는 고급 개발자를 위한 실전 디버깅 기법 12가지를 다루며, 각 기법은 실제 프로젝트에서 바로 적용 가능한 코드 예제와 함께 제공됩니다.

---

마치며

이번 글에서는 Debugging 실전 프로젝트 완벽 가이드에 대해 알아보았습니다. 총 12가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#JavaScript #Debugging #Performance #ErrorHandling #Logging