Zettelkasten

Socket.IO disconnect에서 유저 단위 상태를 지우기 전에 그 소켓이 유저의 현재 소켓인지 확인한다

·수정 1회

요약

  • disconnect 핸들러가 끊긴 소켓의 세션에서 userId를 찾아 유저 단위 키(match_context:<userId>)를 덮어쓰고 지우면, 그 유저가 이미 새 소켓으로 다시 들어와 있을 때 새 소켓의 상태까지 지운다.
  • 이 순서 뒤집힘은 실제로 자주 생긴다. 네트워크가 끊기면 앱은 바로 알아채 유저를 다시 매칭에 들여보내지만, 서버는 ping timeout(기본값 기준 20~45초)이 지나야 옛 소켓을 끊는다.
  • 정리 단계 맨 앞에서 유저→최신 소켓 인덱스(socket:user:<userId>)를 읽는다. 다른 소켓을 가리키면 끊긴 소켓의 세션 키만 지우고 끝낸다.

본문

키 구조

키 값 단위
socket:session:<socketId> userId 소켓마다
socket:user:<userId> 마지막에 인증한 socketId 유저마다
match_context:<userId> 매칭 상태(대기 여부, 조건, 상대) 유저마다 하나

매칭 상태는 소켓이 아니라 유저에 붙어 있다. 같은 유저의 소켓이 잠깐 두 개가 되면 둘이 한 키를 같이 쓴다.

순서가 뒤집히는 과정 (운영 로그로 관찰한 사례)

  1. 소켓 A가 인증하고 매칭 대기에 들어간다.
  2. 와이파이가 끊긴다. 앱은 소켓 disconnect 이벤트를 바로 받아 매칭 화면에서 유저를 내보낸다. 서버에는 끊김 신호가 가지 않아 A는 서버에서 살아 있다.
  3. A의 마지막 이벤트 4초 뒤, 유저가 LTE로 매칭을 다시 시작해 소켓 B가 인증한다. 인증은 match_context:<userId>를 새로 만들고 socket:user:<userId>를 B로 바꾼다. socket:session:A는 그대로 남는다.
  4. B 인증 21초 뒤, 서버가 A를 ping timeout으로 끊는다. A의 disconnect 핸들러는 socket:session:A로 userId를 찾고, 그 키로 B의 매칭 상태를 읽는다. 그 상태를 DISCONNECT로 덮어쓰고, 매칭을 취소하고, 키를 지운다.
  5. B는 세션은 있는데 매칭 상태가 없다. 이후 B의 이벤트는 모두 "MatchContext not found"로 끝난다. 핸들러가 null을 받으면 응답 없이 return해서 앱은 아무 반응도 받지 못한다.

서버만 늦게 아는 이유

  • Socket.IO v4 서버는 pingInterval(기본 25,000ms)마다 ping을 보낸다. pingTimeout(기본 20,000ms) 안에 pong이 없으면 연결을 닫고 사유를 ping timeout으로 남긴다.
  • 그래서 네트워크가 끊긴 시점에 따라 서버가 알아채기까지 20~45초가 걸린다.
  • 낮 6.5시간 운영 로그에서 이런 경우가 23건이었다. 23건 중 19건이 ping timeout이었고, 새 소켓 인증부터 옛 소켓 끊김까지 중앙값 27초, 최대 40초였다. 23건 중 16건은 끊김 시점에 새 소켓이 아직 살아 있어 실제로 매칭이 깨졌다.
  • 밤 15시간 로그로 넓혀 보니 옛 소켓 끊김 사유는 client namespace disconnect 103건, ping timeout 82건이었다. 앱이 직접 닫은 옛 소켓의 끊김도 새 소켓 인증보다 늦게 처리될 수 있다. 왜 늦게 오는지는 확인하지 못했다.

고치는 방법

// disconnect 핸들러, 유저 단위 정리 전
const currentSocketId = await socketSessionService.findSocketIdByUserId(user.id);
if (currentSocketId && currentSocketId !== socket.id) {
  await socketSessionService.deleteSocketSession(socket.id);
  return;
}
  • 같은 핸들러 안에서 키마다 기준이 달랐던 게 원인이었다. socket:user:<userId>는 원래 "현재 소켓일 때만 지운다"는 검사가 있었다. 그런데 match_context:<userId> 삭제에는 그 검사가 없었다.
  • 검사를 삭제 함수 하나에만 넣으면 안 된다. 삭제 앞 단계인 상태 덮어쓰기와 매칭 취소도 유저 단위라서 새 소켓을 망가뜨린다. 그래서 정리 단계 전체 앞에 둔다.
  • 인덱스가 비어 있으면(null) 지금처럼 정리한다. 이 조회는 Redis 오류 때도 null을 돌려준다. 그렇다고 실패할 때 정리를 건너뛰면, 소켓이 하나뿐인 대부분의 유저가 추천 목록과 대기 상태에 남는다. 30일 로그에서 이 조회가 실패한 적은 없었다.

이 검사로 못 막는 틈

  • 인증은 매칭 상태를 먼저 만들고 맨 끝에서 인덱스를 새 소켓으로 바꾼다. 그 사이(인증 처리 중앙값 약 0.3초)에 옛 소켓이 끊기면 여전히 지운다.
  • 앱이 소켓 두 개를 0.05~2.2초 간격으로 열고 나중 것을 먼저 닫는 경우도 있었다. 이때 닫힌 쪽이 인덱스상 현재 소켓이라 이 검사를 통과해 정리한다. 이 경우는 코드로만 판단했고 재현하지 않았다.

관련 노트

참고