Lost connection to MySQL server during query

증상

MySQL 클라이언트에서 다음 오류 메시지가 표시됩니다.

Lost connection to MySQL server during query

오류 식별

1. 현재 화면 또는 로그에서 오류 번호를 확인합니다.
2. 오류 번호가 2013인지 비교합니다.
3. 오류 메시지가 Lost connection to MySQL server during query인지 비교합니다.
4. 오류 번호와 메시지가 일치하면 심볼을 CR_SERVER_LOST로 식별합니다.

이 오류는 클라이언트가 쿼리를 서버에 보낸 뒤 전체 응답을 받지 못한 상태입니다. 쿼리를 보내기 전에 연결을 사용할 수 없었던 오류 2006과는 관찰 구간이 다릅니다. 오류 2006이라면 MySQL server has gone away 문서를 확인합니다.

확인 순서

1. 오류 시각, 실행한 쿼리, 요청 또는 배치 작업 식별자를 기록합니다.
2. 서버 오류 로그와 uptime을 비교해 쿼리 실행 중 서버가 종료되거나 다시 시작됐는지 확인합니다.
3. 특정 쿼리에서만 발생하면 요청 크기와 서버·클라이언트의 패킷 제한을 비교합니다.
4. 장시간 쿼리에서만 발생하면 클라이언트 읽기 시간 제한과 중간 네트워크 장비의 시간 제한을 확인합니다.
5. 여러 쿼리에서 같은 시각에 발생하면 서버·클라이언트 사이의 네트워크 단절과 DNS 이름 확인 상태를 확인합니다.

다음 읽기 전용 조회는 서버가 마지막으로 시작된 뒤의 시간과 현재 제한값을 확인합니다.

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

이 값만으로 원인을 확정할 수는 없습니다. 오류 시각의 서버 로그, 애플리케이션 로그, 쿼리 크기와 함께 비교합니다.

재시도 전 확인

• 쓰기 쿼리가 서버에서 실행된 뒤 응답만 유실됐을 수 있으므로 실행 결과를 먼저 확인합니다.
• 중복 실행에 안전한 작업인지 확인한 뒤 재시도 횟수와 간격을 제한합니다.
• 시간 제한과 패킷 제한을 바꾸기 전에 실제 관찰값이 현재 제한을 넘었는지 확인합니다.

SQLSTATE 참고

MySQL 클라이언트 오류의 SQLSTATE 값은 항상 HY000이므로, 이 오류를 다른 클라이언트 오류와 구별하는 기준으로 사용하지 않습니다.

출처

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