Chroma DB 트러블 슈팅 - 100-hours-a-week/12-marong-Wiki GitHub Wiki

에러 내용

• ChromaDB의 add() 메서드 호출 시 ids 또는 metadatas가 누락되어 예외 발생
• 특정 추천 결과 저장 시점에서 API가 실패하거나 비정상 종료
• 에러 메시지 예시: ValueError: ids and documents must be the same length, KeyError: 'user_id'

---

원인 분석

• ids 또는 metadatas 필드가 리스트 길이에 맞지 않거나 누락된 채로 전달됨
• 루프 내에서 document만 생성하고, id 또는 metadata를 생성하지 않은 경우 발생

---

해결 방법

• add() 호출 전 다음 항목을 반드시 검증:
  • len(ids) == len(documents) == len(metadatas)
  • metadatas 내 필수 키 존재 여부 (user_id, group_id, score 등)

---

회고

• 구조화된 데이터 전달로 안정성 확보
• 사전 검증을 통해 런타임 오류 방지
• 전체 모듈 신뢰도와 유지보수성 향상