텔레그램 뉴스봇이 갑자기 멈췄을 때 초보자인 제가 확인한 순서

안녕하세요 케이입니다.

앞에서는 Google Apps Script의 트리거를 이용해서 정해진 시간에 뉴스가 자동으로 오도록 만들어봤습니다.

자동으로 뉴스가 도착하니까 상당히 편했습니다.

그런데 며칠 사용하다 보니 어느 날 아침 뉴스가 오지 않았습니다.

처음에는 오늘은 뉴스가 없나 싶었습니다.

하지만 직접 /news를 입력해봐도 봇이 제대로 움직이지 않았습니다.

이런 일이 생기면 저처럼 코딩을 모르는 입장에서는 막막합니다.

어디부터 확인해야 할지 모르기 때문입니다.

처음에는 코드를 이것저것 건드려봤는데 오히려 더 복잡해졌습니다.

그래서 지금은 문제가 생기면 확인하는 순서를 어느 정도 정해놨습니다.

가장 먼저 간단한 명령어부터 테스트했습니다

가장 먼저 /help처럼 단순한 명령어를 보내봤습니다.

복잡한 뉴스 검색부터 테스트하면 API가 문제인지 봇 자체가 문제인지 구분하기 어렵습니다.

/help도 아무 반응이 없다면 뉴스 검색 기능보다는 텔레그램과 Google Apps Script 연결 자체를 먼저 의심했습니다.

반대로 /help는 잘 되는데 뉴스 검색만 안 된다면 네이버 API나 뉴스 검색 코드 쪽을 보는 식입니다.

이렇게 문제 범위를 줄이는 게 생각보다 중요했습니다.

Google Apps Script 실행 기록을 확인했습니다

텔레그램에서 메시지를 보낸 다음 Google Apps Script의 실행 기록을 봤습니다.

제가 보낸 시간에 실행 기록이 있다면 적어도 메시지가 Apps Script 쪽까지 들어왔을 가능성이 높았습니다.

반대로 아무 실행 기록도 없다면 Webhook 쪽을 먼저 확인했습니다.

이 방법을 알고 나니까 무작정 코드부터 보는 일이 많이 줄었습니다.

실패라고 나오면 오류 내용을 봤습니다

실행 기록을 눌러보면 성공인지 실패인지 확인할 수 있습니다.

실패한 경우에는 오류 메시지도 나옵니다.

처음에는 영어로 된 오류 메시지가 나오면 거의 이해할 수 없었습니다.

그래도 전부 이해할 필요는 없었습니다.

오류가 난 줄 번호나 함수 이름, undefined, Exception 같은 단어 정도만 확인해도 어느 부분에서 문제가 났는지 대략 찾을 수 있었습니다.

Webhook도 다시 확인했습니다

Apps Script 실행 자체가 되지 않는 경우에는 Webhook 연결을 확인했습니다.

특히 Apps Script를 다시 배포했거나 웹앱 주소가 바뀌었다면 예전에 설정해둔 Webhook 주소와 달라질 수 있었습니다.

이 경우 텔레그램은 예전 주소로 계속 메시지를 보내기 때문에 새 코드가 아무리 정상이어도 작동하지 않을 수 있습니다.

저는 예전에 302 오류 때문에 상당히 오래 막힌 적이 있어서 이제는 이상하면 Webhook을 비교적 빨리 확인합니다.

자동 뉴스만 안 온다면 트리거를 확인했습니다

수동 명령어는 잘 되는데 아침 자동 뉴스만 안 오는 경우라면 트리거부터 확인했습니다.

제가 만든 sendDailyNews 함수가 트리거에 제대로 등록되어 있는지 보고 최근 실행에 실패 표시가 있는지도 확인했습니다.

뉴스 검색만 안 된다면 API를 확인했습니다

텔레그램 봇은 정상적으로 움직이는데 뉴스만 안 나오는 경우도 있습니다.

그럴 때는 네이버 검색 API 쪽을 확인했습니다.

Client ID나 Client Secret이 제대로 들어 있는지, 검색 URL은 맞는지, API 호출 과정에서 오류가 나는지 하나씩 봤습니다.

제가 정한 확인 순서

지금은 대략 이런 식으로 확인합니다.

텔레그램에서 /help 확인

→ /news 확인

→ Google Apps Script 실행 기록 확인

→ Webhook 확인

→ 자동 실행 문제라면 트리거 확인

→ 뉴스만 문제라면 API 확인

→ 마지막으로 코드 수정 부분 확인

이 순서만 정해둬도 예전보다 훨씬 덜 당황하게 됐습니다.

무조건 코드를 새로 붙여넣지는 않았습니다

예전에는 뭔가 안 되면 아예 코드를 새로 복사해서 붙여넣기도 했습니다.

그런데 그렇게 하면 기존에 잘 되던 기능까지 망가질 수 있었습니다.

그래서 지금은 먼저 문제 지점을 찾으려고 합니다.

자동화 기능 하나를 만드는 것보다 고장 났을 때 어디를 봐야 하는지 아는 게 오히려 더 중요하다는 생각도 들었습니다.

다음에는 이 과정에서 생각보다 많이 사용하게 된 Google Apps Script 실행 기록을 조금 더 자세히 살펴보겠습니다.