1. 프로젝트 개요

• 프로젝트명 : HRBANK
• 목적 : 기업의 인사관리 업무를 보다 체계적이고 효율적으로 지원하기 위한 디지털 인사관리 시스템을 개발합니다.
• 핵심 기능
  • 📊 대시보드 : 직원 수 통계를 시각화하여 조직 변동 현황을 한눈에 파악
  • 🏢 부서 관리 : 부서 등록, 조회, 수정, 삭제 기능 제공
  • 👨‍💼 직원 관리 : 직원 정보의 등록, 조회, 수정, 삭제 기능 제공
  • 📝 직원 정보 수정 이력 관리 : 직원 정보 변경 시점과 변경 내용을 추적 및 기록
  • 💾 데이터 백업 : 정기적인 직원 데이터 백업 및 백업 이력 관리 기능
  • 📁 파일 관리 : 파일 저장 및 메타데이터 관리 기능

2. 담당한 작업

• 담당한 역할
  • 주요 기능 : 데이터 백업 관리 + 파일 관리
  • 개발 외 역할 : Git 형상관리, 환경 설정 관리(application.yaml)
• 기여한 부분
  • 요구사항 명세 작성
  • 팀 내 그라운드 룰 및 코드 컨벤션 설계 주도
  • 환경 설정 값 정의 및 관리 (.yaml 프로파일 분리 등)
  • 백업 관리 및 파일 관리 기능 구현 및 테스트 코드 작성
  • @Scheduled 를 활용한 배치 백업 로직 구현
  • 다양한 테스트를 수행하여 버그를 발견하고 해결에 기여

3. 기술적 성과

• Spring Scheduler를 활용한 배치 백업 시스템 구현
• QueryDSL을 도입하여 복잡한 조건부 검색 쿼리를 안전하고 가독성 있게 작성
• DevTools 자동 재시작 기능으로 인해 발생한 스케줄러 중복 실행 문제를 분석 및 해결
• JUnit을 활용한 테스트 코드를 작성하여 안정성 확보

4. 문제점 및 해결 과정

1) 배치 데이터 백업 - 스케줄러 중복 실행 현상

• 발생한 문제
  • 배치 데이터 백업 기능이 짧은 시간 간격으로 여러 번 중복 실행되는 현상이 발생
  • 로그를 통해 @Scheduled 메서드가 반복적으로 호출되는 것을 확인
• 원인 분석
  • Spring Boot DevTools의 자동 재시작 기능이 활성화된 상태였음
  • 이로 인해 ClassLoader가 반복 생성되며 ApplicationContext가 중복 로딩됨
  • 동일한 @Scheduled 메서드를 포함한 Bean이 여러 번 등록되고 동시에 실행된 것 확인
  • (Bean 초기화 로그가 여러 번 출력되었음)
• 해결 방안

  • application.yml에서 DevTools의 자동 재시작 기능을 비활성화함

    spring:
      devtools:
        restart:
          enabled: false
    

  • 이를 통해 ApplicationContext가 한 번만 생성되도록 보장하고, @Scheduled 중복 실행 현상 방지함

• 배운 점 및 개선 사항
  • DevTools가 개발 편의 기능이지만, 스케줄러 중복 실행을 유발할 수 있다는 점을 알게 되었음
  • 예상치 못한 동작이 발생했을 때, 로그를 통한 원인 분석과 설정 점검의 중요성을 알게 되었음

2) 커스텀 어노테이션 적용 시 @target 사용하여 에러 발생