MySQL server has gone away

오류 식별

현재 화면 또는 로그에서 오류 번호와 메시지 문자열을 확인합니다.

• 오류 번호가 2006인지 확인합니다.
• 메시지가 MySQL server has gone away와 일치하는지 확인합니다.
• 코드에서 심볼을 확인할 수 있으면 CR_SERVER_GONE_ERROR인지 확인합니다.

이 값들이 일치하면 MySQL 클라이언트 오류 번호 2006으로 식별합니다.

MySQL 공식 문서에서는 CR_SERVER_GONE_ERROR를 클라이언트가 서버에 쿼리를 보내지 못한 상태로 구분합니다. 쿼리를 보낸 뒤 전체 응답을 받지 못했다면 오류 2013입니다. 해당 문구가 보이면 Lost connection to MySQL server during query 문서를 확인합니다.

확인 순서

1. 마지막 정상 쿼리 시각과 오류 시각 사이의 유휴 시간을 확인합니다.
2. 서버의 wait_timeout과 애플리케이션 연결 풀의 최대 연결 수명을 비교합니다.
3. 서버 uptime과 오류 로그에서 연결 사이에 서버가 종료되거나 다시 시작됐는지 확인합니다.
4. 애플리케이션이 이미 닫힌 연결 객체를 다시 사용했는지 확인합니다.
5. 큰 쿼리나 BLOB 전송에서만 발생하면 서버·클라이언트의 패킷 제한과 요청 크기를 비교합니다.

다음 읽기 전용 조회로 현재 값을 확인할 수 있습니다.

SHOW GLOBAL STATUS LIKE 'Uptime';SHOW GLOBAL VARIABLES LIKE 'wait_timeout';SHOW GLOBAL VARIABLES LIKE 'max_allowed_packet';

wait_timeout을 늘리는 것만으로 연결 관리 오류, 서버 재시작, 패킷 초과, 네트워크 단절은 해결되지 않습니다. 관찰값과 오류 시각의 로그를 확인한 뒤 애플리케이션의 연결 재생성 조건을 수정합니다.

재시도 전 확인

• 같은 연결을 다시 사용하지 말고 클라이언트 라이브러리의 연결 유효성 검사와 새 연결 생성 동작을 확인합니다.
• 쓰기 작업은 서버에서 실행됐는지 확인한 뒤 중복 실행에 안전한 경우에만 제한적으로 재시도합니다.
• 비밀번호, 연결 문자열, 쿼리 값에 포함된 개인정보는 공유 로그에서 제거합니다.

참고

MySQL은 클라이언트 오류의 SQLSTATE 값을 항상 HY000으로 설명하므로, 이 값만으로는 다른 클라이언트 오류와 구분할 수 없습니다.

출처

• MySQL 8.4 Client Error Message Reference (새 창에서 열림)
• MySQL server has gone away (새 창에서 열림)