문제가 생겼을 때 당황하지 마세요

왜 중요한가?

Neo4j 설정 중 흔히 발생하는 문제들과 해결 방법을 미리 알아두면 시간을 크게 절약할 수 있습니다.

이 가이드는 실제 학습자들이 가장 자주 겪는 문제들을 정리했습니다.

핵심 개념

문제 1: 포트 충돌 (Port Already in Use)

증상:

원인: 다른 프로세스(이전 Neo4j, 다른 서비스)가 포트를 점유 중

해결:

---

문제 2: 메모리 부족 (OutOfMemoryError)

증상:

원인: JVM 힙 메모리가 부족

해결:

---

문제 3: 연결 거부 (Connection Refused)

증상:

원인: Neo4j가 아직 시작되지 않았거나 네트워크 설정 문제

해결:

---

문제 4: 인증 실패 (Authentication Failed)

증상:

해결:

---

문제 5: APOC/GDS 플러그인 로드 실패

증상:

해결:

---

문제 6: Aura Free 인스턴스 사라짐

증상: 콘솔에 인스턴스가 없음

원인:

• 30일 비활성 -> 일시 중지 (resume 가능)
• 90일 비활성 -> 영구 삭제 (복구 불가!)

예방:

---

문제 7: LOAD CSV 에러

증상:

해결:

유용한 디버깅 명령어 정리

상황	명령어
서버 상태	:server status
시스템 정보	:sysinfo
DB 연결 확인	RETURN 1
버전 확인	CALL dbms.components()
플러그인 확인	CALL dbms.procedures() YIELD name WHERE name STARTS WITH 'apoc'
인덱스 확인	SHOW INDEXES
제약조건 확인	SHOW CONSTRAINTS
전체 데이터 삭제	MATCH (n) DETACH DELETE n
로그 확인 (Docker)	docker logs neo4j-fde --tail 50

자주 하는 실수

가장 흔한 실수 TOP 5

순위	실수	예방법
1	Aura 비밀번호 미저장	생성 즉시 다운로드
2	포트 충돌 무시	먼저 lsof로 확인
3	메모리 기본값 사용	시스템에 맞게 조정
4	LOAD CSV 타입 변환 누락	toInteger() 필수
5	Aura 비활성으로 삭제됨	월 1회 접속