학습 목표
- 자주 하는 개발 실수와 해결의 역할과 적용 조건을 설명할 수 있다.
- 최근 실패 한 가지를 재현 행동·원인·영향으로 적으세요.
- 재발 방지 문서·검사·복구 지점을 추가하세요.
사전 지식
앞선 규모에 따른 개발 전략를 먼저 읽으면 용어를 이해하기 쉽습니다. 이미 아는 내용이면 이 장부터 시작해도 됩니다.
개념 이해
실수 목록은 남을 평가하기 위한 규칙이 아니라 반복 실패를 줄이는 도구입니다. 원인과 직접 확인할 해결 기준을 한 쌍으로 기록하세요.
한 파일·한 번에 개발·분석 없는 수정
책임과 변경 범위가 커지면 원인을 찾기 어렵습니다. 기능을 작게 나누고 기존 호출 경로와 diff를 확인합니다.
키 노출·권한 미설정
실제 비밀키는 즉시 폐기·재발급을 검토하고 서버 비밀 저장소로 옮깁니다. DB 접근은 공개 설정이나 UI 제한이 아닌 정책으로 통제합니다.
반복 호출·오류 무시·검증 없는 배포
동일 데이터 재요청과 무한 재시도를 측정합니다. 오류 원문과 실제 결과를 읽고 중요한 경로를 확인한 버전만 배포합니다.
Git 미사용·라이브러리 남발·AI 맹신
복구 지점을 남기고 추가 의존성의 유지보수 비용을 검토합니다. AI 코드도 실제 입력과 권한 시나리오로 확인합니다.
과도한 최적화·초기 복잡성·운영비 누락
측정 전 최적화와 불필요한 마이크로서비스는 변경 비용을 높입니다. 현재 병목과 전체 운영 비용을 먼저 관찰합니다.
실제 사용 사례
오류가 났다고 전체 프로젝트를 재작성하면 원인이 사라진 것이 아니라 숨겨질 수 있습니다. 재현 입력과 실패 위치를 남기고 한 원인씩 고치세요.
단계별 실습
실습은 운영 서비스가 아닌 별도 연습 프로젝트에서 진행하세요. 기존 파일이 있다면 변경 전 기록을 남깁니다.
- 최근 실패 한 가지를 재현 행동·원인·영향으로 적으세요.
- 위 실수 중 해당되는 항목과 해결 행동을 고르세요.
- 작은 변경 후 같은 입력·실패·권한으로 다시 확인하세요.
- 재발 방지 문서·검사·복구 지점을 추가하세요.
코드와 프롬프트
아래 요청에서 대괄호 부분을 내 프로젝트에 맞게 바꾼 뒤 AI 도구에 전달하세요.
AI에게 요청하기
[실패 상황]을 원인과 증거부터 분석해줘. 한 파일·대량 수정·키/권한·중복 요청·테스트 누락·Git·의존성·과최적화·복잡성·비용 관점에서 해당 문제만 골라 해결과 직접 확인 기준을 적어줘.자주 발생하는 문제와 해결
| 문제와 원인 | 해결 방법과 확인 기준 |
|---|---|
| 이유를 모르고 같은 코드만 반복 교체함 | 최소 재현과 실제 로그로 원인을 좁힙니다. |
| 경고가 너무 많아 모두 무시함 | 보안·데이터·사용자 영향 기준으로 우선순위를 정합니다. |
핵심 요약
- 원인과 해결을 쌍으로 기록합니다.
- 검증과 복구를 생략하지 않습니다.
완료 확인
참고자료
확인 기준일: 2026-10-20. 요금·사용 한도·제품 기능·설정 경로는 변경될 수 있으므로 작업 직전 공식 문서와 설치 버전을 확인하세요.