Go 언어 sync.Once 활용: 싱글톤 패턴과 지연 초기화의 안전한 구현

핵심 기술

이 문서는 Go 언어의 sync.Once를 사용하여 동시성 환경에서 특정 함수나 연산을 단 한 번만 실행하도록 보장하는 방법을 설명합니다. 이는 싱글톤 패턴 구현 및 지연 초기화에 효과적입니다.

기술적 세부사항

• sync.Once의 역할: 동시성 환경에서 특정 연산이 여러 고루틴에 의해 호출되더라도 정확히 한 번만 실행되도록 보장하는 동기화 프리미티브입니다.
• 주요 메서드 Do(f func()): 인자로 함수 f를 받아 실행하며, 여러 고루틴에서 동시 호출 시에도 f는 단 한 번만 실행됩니다.
• 주요 사용 시나리오:
  • 싱글톤 패턴 구현 (전역 인스턴스 생성 방지)
  • 지연 초기화 (필요할 때 리소스 동적 초기화)
  • 단 한 번만 실행되어야 하는 연산 (설정 로딩, 데이터 정리 등)
• 싱글톤 패턴 예제: sync.Once를 사용하여 instance가 단 한 번만 초기화되도록 보장하고, 모든 고루틴이 동일한 싱글톤 인스턴스를 공유함을 보여줍니다.
• 지연 초기화 예제: Config 구조체의 초기화를 sync.Once를 통해 필요할 때만 수행하여 불필요한 오버헤드를 방지하는 방법을 설명합니다.
• 내부 구현 (sync.Once 소스 코드 분석):
  • done (uint32): 연산 실행 여부를 나타내는 플래그입니다.
  • m (sync.Mutex): 동시성 접근을 제어하기 위한 뮤텍스입니다.
  • Do 메서드는 atomic.LoadUint32로 done을 먼저 확인하고, 필요시 doSlow를 호출합니다.
  • doSlow에서는 뮤텍스를 잠근 후 done을 재확인하는 이중 체크(double-check)를 통해 안전성을 높이고, 함수 실행 후 atomic.StoreUint32로 done을 설정합니다.
  • 이중 체크는 락 경합을 줄여 성능을 향상시킵니다.
• 에러 처리 및 재시도 문제: 표준 sync.Once는 반환 값이 없어 초기화 실패 시 재시도가 어렵습니다. 이를 해결하기 위해 에러 반환 및 조건부 재시도가 가능한 커스텀 Once 구현을 소개합니다.
• 주의사항: sync.Once 내에서 Do를 재귀적으로 호출하면 뮤텍스 데드락이 발생할 수 있습니다.

개발 임팩트

sync.Once를 사용함으로써 동시성 환경에서 싱글톤 인스턴스 생성이나 초기 설정 로딩과 같은 핵심적인 작업을 안전하고 효율적으로 처리할 수 있습니다. 이는 애플리케이션의 안정성과 성능을 보장하는 데 기여합니다. 에러 처리 기능이 강화된 커스텀 구현은 더욱 견고한 초기화 로직을 구축하는 데 도움을 줄 수 있습니다.

커뮤니티 반응

(원문에 명시적인 커뮤니티 반응 언급 없음)