한국투자 Open API 웹소켓 연결이 중단되는 문제

💣 문제 상황

• 서버를 켜놓고 소켓 연결이 정상적으로 완료되어 주가가 실시간으로 변동되는 것을 확인 후 시간이 지나 아침이 되면 소켓 연결이 끊어져 실시간으로 가격이 업데이트되지 않는 문제가 발생함.

✨ 해결 과정

1. 실시간 가격이 정상적으로 업데이트 되지 않는 문제가 프론트-백 소켓 연결 문제인지 백-한투 소켓 연결 문제인지 확인하기 위해 로그 기록을 진행함.

   • 유력한 용의자인 백-한투 사이 연결을 확인하기 위해 아래와 같은 코드를 추가해 백-한투 소켓 연결이 끊어지면 로그를 기록하도록 함.

   this.socket.onclose = () => {
     this.logger.warn(`한국투자증권 소켓 연결 종료`);
   };

   • 로그 확인 결과, 프론트-백 사이 연결은 문제가 없고, 백-한투 사이의 문제라는 것을 알게 됨.
   • 추가로, 장이 마감되고 데이터가 더이상 수신되지 않는 경우 몇 분 지나지 않아 연결이 끊어진다는 사실을 알게 됨.

2. 장이 마감된 이후 몇 분 후 연결이 끊기는 문제의 원인을 찾아봄.

   PR: [BE] 소켓 연결 끊기는 현상 수정

   • 아래 공지사항을 보고, 한국투자증권에서 ping 데이터를 보내준다는 사실을 알게 됨.
   • 연결을 유지하기 위해서는 한투에서 ping 보낼 시에 pong으로 응답해주어야 한다고 생각하고, 아래와 같은 코드를 추가함.
   • 해당 코드를 추가하니, 장 마감 이후 몇 분 지나면 연결이 끊기는 문제는 해결됨.
   • 그러나, 금요일 오후 또다시 연결이 끊기는 문제가 발생함.

this.socket.onmessage = (event) => {
    // ...
    if (json.header.tr_id === 'PINGPONG')
    this.socket.pong(JSON.stringify(json));
    // ...
}

3. 핑퐁 로직 구현에도 불구하고 또 다시 연결이 끊어지는 문제의 원인을 찾아봄.

   PR: [BE] 25.02 소켓 재연결 로직 구현 #126

   • 위 공지사항을 보고, 우리 서버 쪽에서 문제가 없더라도 한투 서버 재기동 시에 소켓 연결이 끊기는 문제가 있다는 사실을 알게 됨.
   • 해당 문제를 해결하기 위해서, 소켓 연결이 끊어질 경우 재연결하는 로직을 추가하도록 결정함.
   • 끊어지고 바로 재연결할 경우 오류가 발생할 위험이 있어 아래와 같이 setTimeout으로 간격을 두고 재연결함.
   • 이제 아래 로그와 같이 연결이 잘 된다!

this.socket.onclose = () => {
  this.logger.warn(`한국투자증권 소켓 연결 종료`);
  setTimeout(() => {
     this.onModuleInit().catch((err) => {
       throw new InternalServerErrorException(err);
     });
  }, 60000);
};

-👓 참고 자료

KIS Developers

한국투자증권 Open API 파이썬 라이브러리 github