컬리 공통 암호화 모듈의 동시성 이슈 해결하기

이 게시물은 컬리 공통 암호화 SDK 모듈에서 발생한 간헐적 버퍼 오류의 원인과 이를 해결한 과정을 소개합니다.

이슈 원인 분석

• AWS KMS를 활용한 암호화 과정 중 ByteBuffer를 공유하며 발생한 동시성 문제
• ByteBuffer의 position과 limit 값이 동시 접근으로 인해 불일치하여 BufferUnderflowException 발생

해결 방안

• 동기화(synchronized) 방법과 별개로 버퍼를 복제하는 duplicate() 메소드 사용
• 스레드마다 독립된 버퍼 객체를 제공하여 동시성 문제 해소

결과 및 교훈

Buffer API 문서상의 thread-safe 주의사항을 참고하여 멀티스레드 환경에서 버퍼 접근 시 복제 또는 동기화가 필수임을 확인하였습니다.