문제 해결 (Troubleshooting)

Sudapapa Diary 사용 중 자주 마주치는 문제와 단계별 해결 방법을 정리했습니다. 진단에 도움이 되는 로그 위치도 함께 안내합니다.

진단 정보 수집

문의 전 또는 자가 진단 시 다음 정보를 미리 확인하면 빠르게 해결할 수 있습니다.

정보	위치
앱 버전	트레이 → 앱 정보
Windows 버전	시작 메뉴 → 정보
로그 파일	%APPDATA%\sudapapadiary\Logs\ (생성 시)
설정 폴더	%APPDATA%\sudapapadiary\Configurations\
DB 파일	Configurations\Database\sudapapa.db
자격 증명 관리자	Windows 자격 증명 관리자 → 일반 자격 증명 → SudapapaDiary

트레이 아이콘이 보이지 않음

증상

앱은 실행 중인데 시스템 트레이(시계 옆)에 아이콘이 보이지 않음.

원인

• Windows 트레이의 숨겨진 아이콘 영역에 들어가 있음(가장 흔함)
• 시스템 시작 직후 트레이 시스템이 아직 준비되지 않음
• 다중 모니터 환경에서 트레이 영역 변경

해결

1. 트레이 영역의 위쪽 화살표(^) 아이콘을 클릭해 숨겨진 아이콘을 펼칩니다.
2. Sudapapa Diary 아이콘을 트레이 본 영역으로 드래그합니다.
3. 또는 Windows 설정 → 개인 설정 → 작업 표시줄 → 작업 표시줄 모서리 오버플로에서 표시 토글을 켭니다.
4. 위 방법으로도 보이지 않으면 앱을 종료한 뒤 재시작합니다.

위젯이 화면 밖에 있음

증상

위젯을 활성화해도 화면에 보이지 않음. 다중 모니터 환경에서 흔히 발생.

해결

1. 위젯 관리 페이지에서 해당 위젯의 토글을 끕니다.
2. 다시 토글을 켜면 기본 위치로 표시됩니다.
3. 그래도 보이지 않으면 트레이 → 앱 정보 → 모든 위젯 위치 초기화(있는 경우)를 사용합니다.
4. 마지막 수단으로 앱 종료 후 sudapapa.db의 widgets 테이블을 백업본으로 복원합니다.

자세한 절차는 위젯 관리 → 위치·크기 초기화 참고.

위젯이 응답하지 않음

증상

위젯이 멈춘 듯 클릭에 반응하지 않음.

해결

1. 위젯의 ⋯ 메뉴 → 새로고침을 시도합니다(있는 경우).
2. 위젯 관리에서 해당 위젯을 비활성화 후 다시 활성화합니다.
3. 그래도 멈춰 있으면 트레이 → 앱 종료 후 재시작합니다.
4. 작업 관리자에서 Sudapapa Diary 프로세스가 비정상 메모리를 사용하는지 확인합니다.

OAuth 인증 실패 (Google·Microsoft·Kakao·Naver)

증상

계정 페이지에서 캘린더 연결을 시도하면 브라우저가 열렸다가 오류 메시지가 나타남.

원인

• 기본 브라우저가 차단하거나 응답하지 않음
• 시스템 시간이 실제와 크게 다름(>5분 차이) → OAuth 토큰 검증 실패
• 방화벽이 콜백 포트(localhost) 차단
• 해당 서비스의 일시적 장애

해결

1. 시스템 시간 확인: Windows 설정 → 시간 및 언어 → 자동 설정 켜기.
2. 브라우저 재로그인: 기본 브라우저에서 해당 서비스에 로그인 상태인지 확인.
3. 방화벽 예외: Windows 방화벽에서 Sudapapa Diary 허용 여부 확인.
4. 인증을 다시 시도. 콘솔 로그에서 정확한 오류 메시지 확인.
5. 그래도 실패하면 보안 및 개인정보의 외부 통신 정책을 검토하고 회사 PC라면 IT 정책 확인.

동기화가 멈춤

증상

외부 캘린더의 새 일정이 앱에 반영되지 않음.

해결

1. 캘린더 위젯의 새로고침 버튼 또는 ⋯ 메뉴 → 지금 동기화 클릭.
2. 계정 페이지에서 해당 계정을 선택하고 다시 인증을 진행.
3. 인터넷 연결 확인.
4. 일정이 너무 오래된 미래(예: 2030년 이후)에 있으면 폴링 윈도우 밖에 있을 수 있음 — 캘린더 보기를 해당 시점으로 이동 후 새로고침.
5. 외부 서비스 자체의 장애 가능성 확인 (각 서비스의 상태 페이지).

일정이 중복으로 보임

증상

같은 일정이 두 번 이상 표시됨.

원인

• 같은 캘린더가 두 계정에 동시 연결됨(예: 가족 공유 캘린더가 두 Google 계정에 모두 표시)
• 동기화가 중간에 끊어진 후 재시도되어 임시 중복

해결

1. 캘린더 관리에서 같은 캘린더가 여러 계정에 표시되어 있는지 확인합니다.
2. 한 계정에서만 보이도록 다른 계정의 해당 캘린더를 비활성화합니다.
3. 임시 중복인 경우 위젯 새로고침으로 해소됩니다.
4. 동기화 캐시를 비우려면 데이터 관리 → 캐시 비우기를 참고합니다.

알림이 오지 않음

증상

알람 시간이 되어도 알림이 표시되지 않음.

해결

1. 환경설정 → 알림에서 모든 알람 비활성화가 켜져 있는지 확인합니다.
2. 방해 금지 시간대에 들어와 있는지 확인합니다.
3. Windows 설정 → 시스템 → 알림에서 Sudapapa Diary 알림 허용 여부 확인.
4. 백그라운드 실행이 켜져 있는지 확인 — 앱이 종료되어 있으면 알림이 동작하지 않습니다.
5. 일정의 알람 설정(분 단위)을 다시 확인합니다.

비밀번호가 사라짐 / 복호화 실패

증상

이전에 저장된 비밀번호가 보이지 않거나 “복호화 실패” 오류.

원인

• Windows 자격 증명 관리자에서 SudapapaDiary 키가 삭제됨
• 사용자 프로필 변경(예: OS 재설치, 다른 사용자 계정으로 로그인)
• 외부 앱이 자격 증명 관리자를 정리

해결

1. Windows 자격 증명 관리자(제어판 → 사용자 계정 → 자격 증명 관리자 → 일반 자격 증명)에서 SudapapaDiary 항목이 있는지 확인합니다.
2. 없다면 키가 손실된 상태로, 암호화된 비밀번호는 복구가 불가능합니다.
3. 다행히 설정 백업이 있다면 복원으로 해결할 수 있습니다.
4. 향후 재발 방지를 위해 정기적으로 백업 파일을 클라우드·외장 드라이브에 보관하세요.

Caution

자격 증명 관리자 키 손실은 가장 치명적인 데이터 손실 시나리오입니다. 중요한 비밀번호는 백업 외에 별도의 안전한 저장소에 이중 보관하시기 바랍니다.

앱이 시작되지 않음

증상

npm start 또는 트레이 아이콘 클릭해도 창이 뜨지 않음.

원인 진단

1. 작업 관리자 → 자세히 탭에서 Sudapapa Diary.exe 또는 electron.exe 프로세스가 이미 실행 중인지 확인합니다. 있으면 종료 후 재시작.
2. 콘솔에서 직접 실행하여 오류 메시지 확인:

   cd <설치 폴더>
   start.cmd

3. %APPDATA%\sudapapadiary\Logs\(있는 경우)의 최근 로그 확인.
4. DB 손상 가능성 — 데이터 관리 → DB 손상 복구 절차 참고.

lru-cache 관련 오류

다음과 같은 오류가 콘솔에 보이는 경우:

TypeError: this._cache.clear is not a function

lru-cache 패키지 v11에서 import 방식이 변경된 것이 원인입니다. 일반 사용자는 만나지 않으며, 개발자 환경이라면 다음으로 해결합니다.

// 변경 전
const LRUCache = require('lru-cache');
// 변경 후
const { LRUCache } = require('lru-cache');

DB 마이그레이션 오류

증상

업그레이드 후 첫 실행 시 “마이그레이션 실패” 오류로 멈춤.

해결

1. 자동으로 Configurations/Backups/migration-backup-<timestamp>/에 백업이 생성되어 있습니다.
2. 앱 종료 후 해당 백업 폴더의 JSON/DB를 원래 위치로 복원합니다.
3. 일시적 실패인 경우 앱을 다시 실행하면 마이그레이션이 재시도됩니다.
4. 반복 실패 시 데이터 관리 → DB 손상 복구 참고.

자동 업데이트 실패

증상

새 버전이 있다는 알림 후 다운로드·설치가 실패함.

해결

1. 인터넷 연결 확인.
2. 백신·보안 소프트웨어가 업데이트 파일을 차단하는지 확인.
3. 수동 업데이트: 공식 배포 페이지에서 최신 설치 파일을 직접 받아 재설치합니다(데이터는 보존됩니다).
4. 디스크 공간 부족 여부 확인.

자동 시작이 동작하지 않음

증상

환경설정에서 자동 시작을 켰는데 부팅 후 앱이 실행되지 않음.

해결

1. Windows 작업 관리자 → 시작 프로그램 탭에서 Sudapapa Diary가 활성화되어 있는지 확인.
2. 비활성 상태면 우클릭 → 사용.
3. 보안 소프트웨어(백신)가 시작 항목 등록을 차단하지 않았는지 확인.
4. 환경설정에서 자동 시작 토글을 한 번 끄고 다시 켜서 항목을 재등록합니다.

디바이스 한도 초과 (구독)

증상

라이선스 인증 시 “기기 등록 한도 초과” 오류 발생.

해결

1. 구독 관리 탭에서 등록된 기기 목록을 확인합니다.
2. 더 이상 사용하지 않는 기기를 식별합니다(기기 이름·등록 일자 참고).
3. 해당 기기의 해제 버튼을 클릭합니다.
4. 30일 내 3회 해제 한도를 초과하지 않았는지 확인합니다.
5. 새 PC에서 라이선스 인증을 다시 시도합니다.

자세한 내용은 구독 및 결제 → 기기 한도 참고.

결제 후 라이선스 활성화 안 됨

증상

Paddle 결제는 완료했는데 앱이 무료 플랜인 채로 유지됨.

해결

1. 30초~1분 대기 후 구독 팝업의 라이선스 검증 버튼을 다시 클릭합니다.
2. 이메일로 받은 영수증에서 라이선스 키(SD-XXXX-XXXX-XXXX)를 확인합니다.
3. 구독 팝업에서 라이선스 키와 결제 이메일을 입력하여 수동 등록합니다.
4. 등록 시도가 10회 실패해 잠금이 걸린 경우 영수증의 거래 번호(txn_*)로 잠금을 해제합니다.
5. 그래도 해결되지 않으면 결제 영수증 이메일 또는 텔레그램 문의 채널로 거래 번호와 함께 문의합니다.

음력·공휴일이 안 맞음

증상

음력 날짜나 공휴일 표시가 실제와 다름.

원인 / 해결

• 음력은 사전 계산된 데이터를 사용합니다. 너무 먼 미래(2050년 이후 등)는 데이터가 없을 수 있습니다.
• 공휴일은 한국 기준이 기본이며, 정부 발표가 늦은 대체공휴일은 업데이트가 필요할 수 있습니다.
• 캐시를 비우려면 데이터 관리 → 캐시 비우기 참고.

메모리 사용량이 너무 큼

증상

작업 관리자에서 Sudapapa Diary가 1GB 이상 메모리를 사용.

해결

1. 사용하지 않는 위젯을 비활성화합니다(특히 메모·즐겨찾기 다중 인스턴스).
2. 캘린더 위젯의 표시 범위를 줄입니다(매우 긴 기간을 한꺼번에 로드하지 않도록).
3. 앱을 재시작합니다.
4. DB가 매우 큰 경우(수만 건의 일정) 일부 오래된 일정을 정리합니다.

Electron 기반 앱은 일반적으로 200~500MB의 메모리를 사용하는 것이 정상입니다.

로그 위치 및 활용

문제 보고나 자가 진단 시 다음 위치를 참고하세요.

• Directory%APPDATA%/sudapapadiary

  • DirectoryLogs (생성된 경우)

    • main-YYYY-MM-DD.log (Main Process)
    • renderer-YYYY-MM-DD.log (Renderer Process)
  • DirectoryConfigurations

    • migration-status.json (마이그레이션 진행 상태)
• Directory%APPDATA%/SudapapaDiary

  • license-server.db (라이선스 캐시)

문의 시 첨부할 정보:

• 앱 버전 (트레이 → 앱 정보)
• Windows 버전
• 재현 절차
• 스크린샷
• 가능하면 최근 로그 파일

그 외 일반 팁

첫 도움 — 재시작

이상한 동작이 보이면 가장 먼저 트레이에서 완전 종료 후 재시작해 보세요.

백업 먼저, 실험 다음

설정·데이터 폴더를 직접 만지기 전에는 반드시 설정 내보내기로 백업을 만드세요.

OS 시간 확인

OAuth·라이선스·동기화 모든 영역이 정확한 시스템 시간에 의존합니다.

권장 환경

Windows 10/11 64비트, RAM 8GB, BitLocker 활성, 최신 보안 업데이트.

문제 해결이 어려운 경우 FAQ 또는 문의 채널로 연락 주세요.