트러블슈팅
1.Spring+Hibernate 환경에서 ClassLoader 충돌로 인한 `QueryTypeMismatchException` 해결
ClassLoader 충돌 해결기
2.URL에 붙는 의문의 `?` 와 fetch 실패
url 뒤에 ? 는 왜 붙는거야?! 그리고 fetch 는 왜 안 되는건데 !!!
3.스윕 라인 알고리즘 적용을 통한 로직 개선
스윕 라인 알고리즘 적용기
4.추천 시스템 유사도 계산 알고리즘 개선
추천 시스템에서 유사도 계산은 어떻게 하는 것이 좋을까?
5.Redis Lua로 살린 실시간 입찰 시스템
비관적 락 동시성 제어 좋긴한데,,,
6.다중 인스턴스 환경에서 실시간 알림 전송하기
다중 인스턴스 환경에서 알림 유실 문제 해결하기!!
7.Render 배포 실패 트러블슈팅
문제 발생 현상 Spring Boot + Supabase(PostgreSQL) 조합의 서버가 Render에서 배포 실패함. 원래는 잘 배포되던 서비스였는데, Supabase DB가 일정 시간 동안 비활성(idle) 상태로 전환되었다가 복구된 이후부터 문제가 생겼다. 초기 에러 로그 JDBCConnectionException 발생 — DB 연결 자체 실패...
8.RAG 검색 품질 개선: Parent-Child Chunking
RAG PDF 분석 서비스 'DocWeave' 개발 과정에서의 트러블슈팅 이번 글에서는 문서 분석 서비스 ‘DocWeave’를 개발하며 RAG의 검색 품질을 개선했던 경험을 공유하고자 합니다. Llama 3.2 모델을 도입하여 사용자 문서 기반의 질의응답 기능을 구현했으나, 모델 자체의 성능보다는 모델에게 전달할 Context를 찾는 과정에서 병목이 발생...
9.LLM Validation (1)
RAG LLM PDF 분석 서비스 'DocWeave' 개발 과정에서의 트러블슈팅 이번 글에서는 'DocWeave' 프로젝트를 진행하며 가장 고민했던 부분인 'LLM 응답의 신뢰성 확보'에 대해 이야기하고자 합니다. 우리는 흔히 LLM을 '똑똑한 AI'라고 생각하지만, 개발자의 관점에서 LLM은 '매우 불안정한 외부 API'일 뿐입니다. 같은 입력에도 매...
10.병렬 처리로 On-Device LLM 최적화하려다가...
RAG PDF 분석 서비스 'DocWeave' 개발 과정에서의 트러블슈팅 지난 글에서는 LLM의 환각 현상을 잡기 위해 Validation 로직을 도입한 과정을 소개했습니다. 검증을 통해 응답의 신뢰성은 확보했지만, 새로운 문제가 발생했습니다. 바로 '속도(Latency)'입니다. 로컬 환경(Galaxy Book 3 Pro, i5-1340p, iris ...
11.비동기 처리 (feat. 근데 이제 레디스를 곁들인...)
RAG PDF 분석 서비스 'DocWeave' 개발 과정에서의 트러블슈팅 이번 글에서는 '안정성(Stability)'과 '확장성(Scalability)'을 위해 서비스 내에 비동기 처리를 도입했던 과정에 대해 이야기를 해보려 합니다. 사용자가 PDF 문서를 업로드하고 이를 분석(Parsing & Embedding)하는 과정에서 겪었던 문제점과, 이를 Re...
12.Vector DB 마이그레이션: 왜 pgvector 대신 Qdrant를 선택했나
RAG 기반 PDF 분석 서비스 'DocWeave' 성능 최적화 과정 지난 글에서는 비동기 처리를 통해 서비스의 안정성을 확보한 과정을 다뤘습니다. 이번 글에서는 RAG(Retrieval-Augmented Generation) 서비스의 핵심 구성 요소인 Vector DB를 교체하며, 검색 성능(Latency)과 처리량(Throughput)을 개선한 경험을...