05. Obsidian EPERM 오류 해결

Obsidian의 EPERM 오류는 보통 권한 자체보다 네트워크 드라이브 상태 + 플러그인 파일 접근 충돌에서 발생합니다. 이 문서는 현장에서 복구율이 높은 순서대로 정리한 5~15분 복구 가이드입니다.

flowchart TD
A[EPERM 발생] --> B[Safe Mode 확인]
B --> C{재현됨?}
C -- 아니오 --> D[문제 플러그인 식별]
C -- 예 --> E[드라이브 재마운트]
E --> F[권한/캐시 재점검]
F --> G[로컬 Vault 임시 전환]

5분 빠른 복구 순서

1. Obsidian Safe Mode로 재실행
2. 네트워크 드라이브 연결 해제/재연결
3. .obsidian/workspace.json 재생성
4. 문제 플러그인 비활성화
5. 필요 시 로컬 Vault로 임시 전환

자주 쓰는 점검 명령 (Windows PowerShell)

# 네트워크 드라이브 확인
net use
 
# 드라이브 해제 후 재연결(예시)
net use Z: /delete
net use Z: \\SERVER\SHARE /user:USERNAME PASSWORD /persistent:yes

증상별 빠른 대응

• 특정 노트 열 때만 EPERM
  → 플러그인 충돌 가능성 높음(커뮤니티 플러그인부터 off)

• 모든 노트에서 랜덤 EPERM
  → 네트워크 드라이브 캐시/연결 불안정 의심

• 재부팅 후 반복
  → 드라이브 자동연결 실패 또는 권한 재인증 누락

재발 방지 체크리스트

• 네트워크 드라이브를 영구 연결로 구성했는가?
• 핵심 플러그인만 최소 유지하는가?
• .obsidian 폴더 정기 백업이 있는가?
• 장시간 작업은 로컬 Vault 우선 원칙을 쓰는가?

운영 팁

• 문서 편집은 로컬, 백업/동기화는 배치로 분리하면 안정적
• 장애 재현 조건(시간/파일/플러그인)을 짧게 기록하면 다음 복구가 빨라짐

함께 보면 좋은 문서

• 14-윈도우우분투폴더
• 06-학습트랙