🛠️ 트러블슈팅 (Troubleshooting)¶

실무에서 발생한 기술적인 문제들과 그에 대한 원인 분석, 해결 과정을 정리한 공간입니다. 각 이슈의 상세 내용은 해당 기술 카테고리의 원본 문서를 연결합니다.

☕ Java & Spring¶

Virtual Thread Pinning 이슈 (FTP/SFTP): 레거시 라이브러리의 synchronized 블록으로 인한 OS 스레드 고갈 문제.
K8s 환경의 Virtual Thread 주의사항: CPU Throttling 및 메모리 팽창 이슈 분석.
Kafka Consumer 가상 스레드 Pinning 이슈: KafkaClient 내부 synchronized 블록으로 인한 캐리어 스레드 고갈 문제.
JDBI 가상 스레드 Pinning 해결 패턴: 하이브리드 스레드 모델을 이용한 DB Blocking I/O 최적화.
K8s Spring 프로파일 우선순위 이슈: 환경 변수와 실행 인자 간의 설정 덮어쓰기 문제 및 BeanPostProcessor를 이용한 프로그래밍 방식의 해결책.
로깅 설정 YAML to XML 전환 이슈: 외부 SDK의 logback.xml과 application.yml 설정 충돌 해결 사례.
SLF4J addKeyValue를 ECS 로그에 포함하기: 커스텀 키가 ECS JSON 로그에 나타나지 않는 문제 해결 및 대안 제시.

Kafka RoundRobinPartitioner 불균형 (KAFKA-9965): 특정 파티션으로 메시지가 쏠리는 버그 분석.
Kafka 최신 버전 Offset 불균형 문제: Sticky 전략과 배치 메커니즘 충돌 해결 방안.
Kafka abortOnNewBatch와 파티션 쏠림: 커스텀 파티셔너 사용 시 특정 파티션으로 전송이 집중되는 이슈 분석.
Kafka Consumer 종료 시 IllegalStateException: 이미 종료된 Consumer에 접근할 때 발생하는 예외 해결 방법 (wakeup vs close).
Hadoop/Tez 네트워크 RX 에러로 인한 작업 지연: 특정 노드의 하드웨어 결함으로 인한 전체 분산 처리 성능 저하.
대량 파일 전송 용량 불일치 이슈: rsync 복사 후 원본과 대상의 용량이 차이 나는 원인 분석.
MinIO 버저닝 활성화 후 삭제 지연 이슈: 삭제 마커로 인해 파일이 영구 삭제되지 않는 문제 및 버전별 삭제 처리 방법.

💡 새로운 이슈가 해결될 때마다 이 목차에 추가하여 지식을 공유합니다.