MySQL 저장·수정 중 오류가 표시돼요
MySQL 데이터 저장·수정 과정에서 외래 키, 중복 키, 열 길이 오류가 표시될 때 원문 메시지를 기준으로 확인 문서를 고릅니다.
빠른 답변
MySQL 저장 오류가 발생하면 쿼리나 데이터를 바로 삭제·수정하지 말고 오류 번호, 실행한 작업, 대상 테이블과 열 이름을 기록한 뒤 같은 오류 문구를 다루는 문서를 확인해야 합니다.
이 가이드가 맞는 경우
- 애플리케이션 오류 메시지
상황별 다음 단계
Cannot add or update a child row: a foreign key constraint fails
로그에 Cannot add or update a child row: a foreign key constraint fails가 표시됩니다.
Can't write; duplicate key in table '%s'
로그에 Can't write; duplicate key in table이 표시됩니다.
Data too long for column '%s' at row %ld
로그에 Data too long for column ... at row가 표시됩니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 오류 번호와 메시지, 실행한 저장·수정 작업을 전달합니다.
- 대상 테이블과 열 이름, 영향을 받은 레코드 범위를 전달합니다.
- 실제 개인정보와 운영 데이터를 포함한 SQL·값은 그대로 전달하지 않습니다.
알아둘 점
데이터 저장 오류는 같은 화면에서 발생해도 제약 조건과 값 형식에 따라 다른 문서로 확인해야 합니다. 오류 메시지, 대상 테이블·열, 실행한 작업을 기록하세요.
먼저 기록할 것
- 오류 번호와 원문 메시지를 기록합니다.
- 저장·수정하려던 기능과 대상 테이블·열 이름을 기록합니다.
- 동일 작업을 여러 번 재시도하거나 운영 데이터를 임의로 삭제하지 않습니다.
원문과 일치하는 항목이 없으면 실패한 작업의 식별 정보만 보관해 데이터베이스 담당자에게 전달하세요.
참고 자료
Server Error Message Reference | MySQL 8.0 Reference Manual (새 창에서 열림)
MySQL · 공식 자료 · 확인 범위: guide-branch-mysql-data-errors · 확인일: 2026-07-27