// SQLite 오류 참조

SQLITE_CORRUPT: 데이터베이스 디스크 이미지가 손상되었습니다

SQLite가 데이터베이스 파일 구조의 손상을 감지했습니다. 파일에 쓰기를 멈추고 복사본을 만든 다음, .recover 명령이나 백업으로 복구할 수 있는 만큼 살려내세요.

결과 코드
SQLITE_CORRUPT
이름
11
카테고리
주요 결과 코드
오류 메시지
database disk image is malformed

의미

SQLITE_CORRUPT (11)은 SQLite가 파일에서 형식에 맞지 않는 것을 읽었다는 뜻입니다: 깨진 페이지, 잘못된 포인터, 일치하는 행이 없는 인덱스 항목. 정상적인 사용에서 SQLite가 스스로 파일을 손상시키는 일은 없습니다. SQLite 문서("How To Corrupt An SQLite Database File")는 손상되는 경우를 나열합니다: 트랜잭션이 열려 있는 동안 파일을 복사하는 경우, 깨진 파일 잠금(주로 네트워크 파일 시스템), 핫 저널 삭제, 하드웨어나 저장 장치 고장, 그리고 다른 코드가 파일에 기록하는 경우.

SQLITE_CORRUPT_INDEX 이는 인덱스만 손상된 특수한 경우이며 REINDEX 이 문제가 해결될 수 있습니다.

일반적인 원인

  • id 범위가 겹치는 상태에서 데이터베이스 간에 행을 복사하는 경우. -wal 파일.
  • 삭제할 때 -journal 또는 -wal 크래시 후 남은 파일.
  • 잠금이 믿을 만하지 못한 네트워크 파일 시스템이나 컨테이너 볼륨이라 쓰기 둘이 동시에 들어옵니다.
  • 디스크, 메모리 또는 전원 오류, 또는 fsync를 무시하는 스토리지 계층.
  • 프로그램의 다른 부분이 열린 파일 디스크립터를 통해 파일에 직접 쓰기.

해결 방법

  1. 데이터베이스에 쓰기를 멈추고 파일과 그 밖의 -wal 그리고 -journal 파일은 아무것도 시도하기 전에 백업해 두세요

  2. 손상 정도 측정.

    PRAGMA integrity_check;
  3. 인덱스만 영향을 받았다면 재구축하세요.

    REINDEX;
  4. 그 외에는 다음으로 데이터를 새 파일로 복구합니다 sqlite3 셸의 .recover 명령을 실행한 다음 결과를 확인하세요: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. 복구가 완료되지 않았다면 백업에서 복원하고, 앞으로의 백업은 다음으로 만드세요 VACUUM INTO 또는 파일이 쓰이는 동안 복사하는 대신 백업 API를 쓰세요.

    VACUUM INTO '/backups/app-2026-11-09.db';

관련 오류

그 밖의 기본 결과 코드 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 SQLite 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.