MySQL에 큰 데이터를 저장할 때 패킷 오류가 나요

게시글·상품 설명·이미지 메타데이터처럼 큰 요청을 저장할 때 max_allowed_packet 또는 연결 상태를 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.

먼저 기록할 것

1. 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
2. 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
3. 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
4. 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.

상황별 다음 단계

1. 전송한 패킷이 max_allowed_packet보다 큼이면 Got a packet bigger than 'max_allowed_packet' bytes 문서를 확인합니다.
2. 동시에 열린 MySQL 연결 수가 제한에 도달함이면 MySQL 연결 수가 max_connections에 도달함 문서를 확인합니다.
3. 애플리케이션이 MySQL 호스트·포트에 연결하지 못함이면 Can't connect to MySQL server on '%s:%u' (%d) 문서를 확인합니다.

확인 순서

1. 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
2. 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
3. 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
4. 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.

패킷 크기 오류 판정

관찰값	판정 기준	다음 확인
max_allowed_packet보다 큰 요청·응답	서버 또는 클라이언트 제한을 초과한 상태입니다.	양쪽의 실제 설정값과 데이터 크기를 비교합니다.
작은 요청도 연결 실패	패킷 크기만의 문제가 아니라 호스트·포트·연결 상태를 확인해야 합니다.	동일 연결의 기본 쿼리 결과를 비교합니다.
특정 파일·BLOB 작업만 실패	요청 본문·결과 집합·드라이버 버퍼 크기를 구분합니다.	실패 데이터 크기와 드라이버 로그를 기록합니다.

전역 패킷 제한을 크게 올리기 전에 실패 데이터 크기와 서버·클라이언트 설정을 모두 기록합니다. 운영 데이터가 포함된 요청을 공개 로그에 남기지 않습니다.

수정 후 재확인

1. 작은 데이터와 실패했던 데이터 크기를 나눠 같은 쿼리를 실행합니다.
2. 서버·클라이언트·프록시의 패킷 제한이 서로 다른지 확인합니다.
3. 설정 변경 후 연결 재수립과 애플리케이션 재시작이 필요한지 확인합니다.
4. 정상 요청·대용량 요청·동시 요청에서 오류가 재현되지 않는지 기록합니다.

관련 점검표: MySQL 연결·업그레이드 운영 확인표

오진하지 않기

이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.