(MySQL/MariaDB) 데이터가 저장되지 않는 5가지 이유와 해결 방법

안녕하세요, 코딩하는곰입니다. 오늘은 MySQL이나 MariaDB를 사용하면서 가장 당황스러운 상황 중 하나인 ‘쿼리를 실행했는데 데이터가 저장되지 않는 현상’을 파헤쳐보겠습니다. 20년간의 DB 개발 경험에서 마주친 다양한 사례들을 바탕으로, 데이터 저장 실패의 5가지 주요 원인과 그 해결책을 상세히 설명드리겠습니다. 특히 트랜잭션 관리와 권한 문제에 대해 깊이 있게 다루어 여러분의 개발 시간을 단축시켜 드릴 예정입니다.

🤖 AI와 머신러닝 개발에 관심이 있다면, (자바 실무) CSV 파일 읽기/쓰기 완벽 가이드 - 코딩하는곰의 Java 입출력 활용를 참고해보세요.

1. 트랜잭션 미커밋 - 가장 흔한 실수

MySQL(InnoDB 스토리지 엔진)이나 MariaDB에서 데이터가 저장되지 않는 가장 흔한 원인은 트랜잭션을 시작한 후 커밋(COMMIT)을 하지 않는 경우입니다. 기본적으로 AUTOCOMMIT 모드가 활성화되어 있지만, 여러 쿼리를 하나의 작업 단위로 처리하기 위해 수동으로 트랜잭션을 시작한 경우 반드시 명시적으로 커밋해야 합니다.

START TRANSACTION;
INSERT INTO users (name, email) VALUES ('곰돌이', 'bear@example.com');
-- COMMIT; 을 실행하지 않으면 실제로 데이터가 저장되지 않음

이 상황을 확인하려면 현재 세션의 AUTOCOMMIT 상태를 확인하세요:

SHOW VARIABLES LIKE 'autocommit';

만약 autocommit=OFF로 설정되어 있다면, 모든 변경 사항은 명시적 COMMIT이 필요합니다. 또한 다른 세션에서는 해당 데이터가 보이지 않아 마치 저장되지 않은 것처럼 보일 수 있습니다. 이는 트랜잭션의 격리 수준(Isolation Level)과도 관련이 있습니다.

🚀 개발자 커리어를 준비하고 있다면, (자바 기초) 첫 프로그램 구조 완벽 해부 - class, main, 파일명의 관계를 참고해보세요.

2. 권한 문제 - 쿼리는 실행되지만 실제로는 저장 실패

두 번째로 흔한 문제는 사용자 권한입니다. 사용자에게 INSERT 권한은 있지만 실제로 데이터를 저장할 수 있는 충분한 권한이 없는 경우입니다. 특히 테이블 수준의 권한과 데이터베이스 수준의 권한을 모두 확인해야 합니다.

-- 현재 사용자의 권한 확인
SHOW GRANTS FOR CURRENT_USER;

예를 들어, 사용자에게 ‘SELECT, INSERT’ 권한만 부여된 경우, 외래 키 제약 조건이 있는 테이블에 데이터를 삽입할 때 문제가 발생할 수 있습니다. 또한 테이블에 트리거가 설정되어 있는 경우, 트리거 실행 권한이 필요할 수 있습니다. 권한 문제를 디버깅하려면 MySQL 에러 로그를 확인하세요:

-- 에러 로그 파일 위치 확인
SHOW VARIABLES LIKE 'log_error';

특히 AWS RDS나 다른 관리형 서비스를 사용하는 경우, 기본 권한 설정이 예상과 다를 수 있으므로 주의가 필요합니다.

매일 두뇌 훈련을 위한 스도쿠를 풀고 싶다면, 클래식과 스토리 모드를 모두 제공하는 스도쿠 저니를 다운로드하세요.

3. 무결성 제약 조건 위반 - 쿼리 실패지만 오류를 놓치는 경우

데이터가 저장되지 않는 세 번째 이유는 무결성 제약 조건(PRIMARY KEY, FOREIGN KEY, UNIQUE, CHECK 등)을 위반했지만 애플리케이션에서 이 오류를 제대로 처리하지 못하는 경우입니다.

-- 유니크 제약 조건 위반 예시
INSERT INTO products (product_id, name) VALUES (1, '노트북');
-- 동일한 ID로 다시 삽입 시도하면 실패하지만, 오류 메시지가 표시되지 않을 수 있음

이 문제를 진단하려면 STRICT 모드를 활성화하는 것이 좋습니다:

SET sql_mode = 'STRICT_ALL_TABLES';

또한 애플리케이션 코드에서는 반드시 SQL 실행 결과를 확인하고, MySQL 오류 코드(예: 1062 - 중복 키 오류)를 처리해야 합니다. InnoDB의 경우 외래 키 제약 조건으로 인해 부모 테이블에 해당 키가 없으면 데이터 삽입이 실패할 수 있습니다.

🎤 놓치면 아쉬운 대회와 전시 일정이 궁금하다면, 제15회 진안고원 수박축제를 참고해보세요.

데이터베이스에 데이터가 저장되지 않는 문제는 다양한 원인이 복합적으로 작용할 수 있습니다. 오늘 살펴본 트랜잭션 관리, 권한 문제, 무결성 제약 조건 외에도 스토리지 엔진 문제, 디스크 공간 부족, 데드락 등이 원인일 수 있습니다. 문제 해결의 첫걸음은 시스템 로그와 쿼리 실행 결과를 꼼꼼히 확인하는 것입니다. 코딩하는곰의 다음 포스팅에서는 더 심층적인 MySQL/MariaDB 트러블슈팅 기법을 다룰 예정입니다. 궁금한 점이 있으면 댓글로 남겨주세요! 여러분의 DB 문제를 해결하는 데 이 글이 도움이 되었기를 바랍니다.

📅 다양한 문화행사를 한눈에 보고 싶다면, 2025 전주세계소리축제를 참고해보세요.