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

컬리의 공통 암호화 SDK에서 간헐적으로 `newPosition > limit` 오류가 발생해, 일부 고객의 전화번호가 빈칸으로 표시되는 문제가 생겼습니다. 원인을 추적한 결과 Caffeine 캐시에 저장된 AWS KMS Data Key의 `ByteBuffer`를 여러 스레드가 공유했고, `clear()`와 `get()`이 변경하는 position 상태가 서로 영향을 주는 동시성 문제였습니다. 고정 스레드 풀로 암호화 로직을 병렬 실행하고 버퍼 상태를 출력해 문제를 재현한 뒤, 성능 저하가 우려되는 `synchronized` 대신 `duplicate()`로 스레드별 버퍼를 사용하도록 바꿨습니다. 공유 버퍼는 여러 스레드에서 안전하지 않으므로, 상태를 변경하는 API의 thread-safety를 확인하고 독립된 버퍼를 제공해야 한다는 점을 보여줍니다.

• ByteBuffer의 position과 limit은 버퍼 상태를 나타내며, 상대적 읽기 작업은 position을 변경한다.
• 공유 객체의 메서드가 thread-safe한지 API 문서에서 확인하고, 여러 스레드가 접근할 때는 상태 변경 여부를 점검한다.
• 동시성 문제를 재현할 때는 고정 스레드 풀로 요청을 병렬 실행하고 position·limit 같은 내부 상태를 기록한다.
• 공유 버퍼를 동기화하면 성능 비용이 생길 수 있으므로, duplicate()나 asReadOnlyBuffer()로 스레드별 버퍼를 사용하는 방법을 검토한다.