툴 스테이션 9번
목록으로 돌아가기

버그 보고 기술: 개발자가 몇 초 만에 이해할 수 있는 버그 보고서를 작성하는 방법

좋은 버그 보고서는 복구 프로세스 속도를 크게 높일 수 있습니다. 템플릿, 심각도 등급, 개발자와 효과적으로 소통하는 방법 등 버그 보고에 대한 모범 사례를 공유합니다.

품질보증 버그 신고 심각도 등급 지라 의사소통 능력 품질 보증

마지막 업데이트:2026-03-07

이 문서에서는 일반적인 버그 보고 모범 사례를 제공합니다. 실제 형식은 팀 규범에 따라 달라질 수 있습니다.

1. Bug Report는 QA의 명함입니다.

개발자들이 가장 보기 두려워하는 버그리포트: "기능이 망가졌으니 고쳐주세요." "몸이 안 좋아"라는 말을 듣고 시작할 길이 없는 의사처럼 단계도 없고, 환경도 없고, 스크린샷도 없습니다.

2. 완벽한 버그 보고서 템플릿

좋은 버그 보고서에는 다음 필드가 포함되어야 합니다.

  • 제목

    [모드] 문제를 간략하게 설명해주세요

  • 심각성

    P0/P1/P2/P3

  • 환경

    OS/브라우저/앱 버전/테스트 환경

  • 전제 조건

    재현하려면 어떤 상태가 필요합니까?

  • 재현 단계

    1-2-3 단계가 명확하고 재현 가능합니다.

  • 예상 결과와 실제 결과

    일어나야 할 일과 실제로 일어난 일

  • 충수

    스크린샷/동영상/로그

  • 주목

    발생 빈도, 관련 티켓 등

3. 심각도 등급 척도

명확한 심각도 등급은 팀이 해결 우선순위를 결정하는 데 도움이 됩니다.

  • P0-차단제

    시스템 가용성, 데이터 손실, 보안 침해. 예: 로그인 기능이 완전히 비활성화되어 결제 금액에서 잘못된 금액이 차감되었습니다.

  • P1-중요

    주요 기능에 이상이 있으며 해결 방법이 없습니다. 예: 잘못된 검색 결과, 핵심 프로세스를 완료할 수 없음

  • P2-메이저

    기능에 버그가 있지만 해결 방법이 있습니다. 예: 내보내기 기능이 실패했지만 다른 방법을 통해 데이터를 얻을 수 있습니다.

  • P3 - 미성년자

    기능에 영향을 주지 않는 사소한 문제입니다. 예: 텍스트 오타, 정렬 미세 조정, 비핵심 페이지 스타일

4. 좋은 버그 보고서와 나쁜 버그 보고서

나쁜 쓰기 방식: "로그인하는 데 문제가 있고 가끔 실패합니다." 작성하는 좋은 방법은 다음과 같습니다. "[로그인] Google OAuth를 사용하여 로그인할 때 계정이 두 개의 이메일에 바인딩된 경우 두 번째 이메일로 로그인하면 500 오류가 발생합니다." 그런 다음 사용된 테스트 계정, 특정 작업 단계, 콘솔 로그 스크린샷, 네트워크 탭의 오류 응답을 첨부하세요.

5. 버그 보고서를 위한 의사소통 기술

원활한 의사소통은 수리를 더욱 효율적으로 만듭니다.

  • 객관적인 설명

    "누가 잘못했는지"보다는 "무슨 일이 있었는지"를 설명하세요.

  • 맥락을 제공하다

    이 버그는 얼마나 많은 사용자에게 영향을 미치나요? 해결 방법이 있나요?

  • 활성 추적

    수리 후에는 문제가 해결되었는지 적극적으로 확인하십시오.

  • 버그와 기능 식별

    버그인지 디자인인지 확실하지 않습니까? 먼저 물어보고 나중에 보고하세요

6. 버그 추적 도구 권장 사항

팀에 적합한 도구를 선택하세요.

  • 지라

    업계 표준, 강력하지만 높은 학습 곡선

  • 선의

    빠르고 현대적인 인터페이스로 중소 규모 팀에 적합

  • GitHub 문제

    오픈 소스 프로젝트에 적합한 코드 베이스와 통합

  • 버그질라

    안정적이고 신뢰할 수 있는 오랜 전통의 도구

  • 개념

    소규모 팀이 빠르게 시작하기에 적합한 유연한 데이터베이스

7. QA와 개발의 관계

QA는 문제를 일으키기 위해 존재하는 것이 아니라 도움을 주기 위해 존재합니다. 좋은 QA 및 개발 관계는 협력 ​​관계입니다. 요구 사항을 함께 검토하여 사전에 문제를 찾고, 버그에 대해 적절하게 논의하고, 서로의 작업 압력을 이해하고, 고품질 제품을 제공한다는 공통 목표를 가지고 있습니다.

ℹ️

요설

본 사이트에 제공된 정보는 참고용일 뿐이며 그 완전성과 정확성을 보장하지 않습니다. 사용자는 정보의 적용 가능성에 대해 스스로 판단해야 합니다.

피드백