giscus 라이브러리 Fetch Faild 이슈
무슨 이슈였나
이전 게시글 작성을 끝내고 나서 게시글을 확인하니, 난데없이 밑에 오류 발생:fetch failed 라는 문구가 생겼다. 마치 게시글의 일부인 것 마냥 자연스럽게 적혀있어서 ‘내가 저런걸 적었던가..?’ 하고 마크다운을 다시 확인했는데 당연히 저런게 있을리는 없었다.
뭔가 허전해서 잘 살펴보니 원래 저 자리에 있었던 댓글 라이브러리인 Giscus에서 오류가 발생한 것이었다.
처음엔 라이브러리가 업데이트 되었다거나 하는 이유로, 코드를 수정해서 다시 적용해야 하는건가 싶었지만 그런건 아니었다. 검색해봐도 딱히 나오는건 없어서 에러 메세지에 나온 대로 이슈 페이지에 들어가 보았더니 다행히도 Closed된 이슈 중에 동일한 문제에 대한 이슈가 있었다.
이슈에 올라온 개발자의 메세지는 다음과 같았다.
토큰을 캐시하는 데 사용하는 컴퓨팅 인스턴스가 어떤 이유로 오늘 아침 응답하지 않게 되었습니다. 새 서비스를 만들고 서비스 경로를 다시 지정했습니다. 이제 괜찮을 것입니다. 신고해 주셔서 감사합니다
- laymonage
그렇다.. 이건 나의 개발 실수도, 라이브러리 업데이트도 아닌 라이브러리 자체에 오류가 발생한 것이었다.
지금껏 개발을 하면서 이런 경우는 처음이었기에 라이브러리 자체에 문제가 있을 거라고는 생각도 못하고 있었다. 이 이슈를 보기 전까지는 말이다.
새로운 이슈를 올린 이유
Happened again..!
여기서 매우 반가웠던 점이, 내가 이 이슈를 읽기 8분 전에 동일한 이슈가 다시 발생했다고 댓글을 남긴 분이 있었다는 것이다.
여기에 댓글이 달렸으니 개발자님이 고쳐주시겠지 하고 넘어가려 했으나, 문득 closed된 이슈에는 댓글을 달아도 메일이 오지 않았던 게 생각이 났다.
그래서 차라리 이 이슈를 멘션한 새로운 이슈를 남겨서 개발자 님에게 오류 발생 사실을 알려야겠다고 생각했다.
다행히 그냥 이전의 이슈를 멘션하고 ‘happened again’ 이라고만 해도 돼서 나의 보잘것 없는 영어실력이 발목을 잡는 일은 없었다.
그리고 이슈를 올린지 5분도 채 지나지 않아, 동일한 문제를 겪고 있는 분들이 댓글을 달아주었다.
개발자의 답변
얼마 지나지 않아, 개발자 님에게서 답변이 달렸다.
이렇게 답변이 빨리 달릴 거라곤 생각지 못했는데, 답변 내용은 더 생각지 못한 것이었다.
이 문제에 대해 인지하고 있지만, 지금 휴가 중이고 노트북이 없기 때문에 1월 2일까지는 문제를 해결하지 못할 것 같습니다.
- laymonage
어쩌다 giscus 개발자님의 휴가 소식을 알게 되었다.
역시 쉬는날 노트북 안가져가면 갑자기 장애 터지는건 전세계 개발자 공통인 것 같다.
아무튼 짧은 감사 인사를 남기고, 이후에 이어진 다른 개발자의 문의사항에 파파고의 힘을 빌려 답변을 남겨주고 마무리 했다.
깨달은 점
1. 발생했던 이슈와 해결법은 잘 기록해놓자
만약 내가 오류 발견 후에 github issue 를 확인하지 않았더라면, 대체 무엇이 문제인가 하고 한참을 붙잡고 있었을 것이다. 누군가가 이전에 겪었던 이슈사항이 잘 기록되어 있었기에 동일한 이슈가 발생했을 때 빠르게 해결할 수 있었던 것이다.
꼭 깃허브 issue 를 활용하지 않더라도, 협업을 할 때든 혼자서 개발할 때든 이슈 기록은 잘 해두는게 좋다는 것을 깨달았다. 특히 협업을 할 땐 나의 기록으로 누군가의 삽질을 예방해줄 수 있다는 큰 효과가 있기에 더욱 기록을 잘 남겨둬야 한다. (그 누군가가 또다시 내가 될 확률도 매우 크다)
2. 에러를 띄울 땐 어느 정도의 성의는 보이자
솔직히 개발자님에게 좀 아쉬웠던게, 라이브러리 자체 에러가 발생했을 때 그걸 좀 더 명확하게 표시해 주셨으면 했던 점이다. 초반에 보여준 것처럼, 그저 ‘오류발생: fetch failed’ 라는 텍스트만 보이니까 블로그 개발자 입장에서도 이게 난데없이 어디서 나온 에러인지 한눈에 파악하기도 어렵고, 블로그를 읽는 사람들도 당황스러웠을 것이다.
라이브러리 오류의 또다른 피해자들..
내가 만들어본 giscuss 에러창
아쉬운 마음에 피그마로 대강 giscuss 에러창을 만들어봤다.
내가 UI/UX에 대해 잘 알지는 못하지만, 적어도 에러 영역을 눈에 띄게 잡아주고 giscus 로고라도 띄워 주었으면 좀 낫지 않았을까 하는 개인적인 의견을 반영했다.
- 버전 1
- 버전 2
그냥 개발이나 열심히 하자..
마치며
사실 개발자가 오픈소스에 issue를 남겼다는 게 이렇게 하나하나 적어둘 정도로 대단한 일도 아니고 어느정도 개발 좀 해본 사람이라면 매우 흔한 일이겠지만, 나에겐 이번이 처음이었고 생각보다 정말 신기하고 새로운 경험이어서 이렇게 블로그에 바로 글을 썼다.
비록 내가 영문으로 잘 정리된 이슈를 올린 것도 아니고, 딱히 그렇게 의미있는 대화를 나눈 것 같지도 않지만 이렇게 공개된 레포지토리에 이슈를 올리고 댓글로 전 세계의 개발자들과 소통을 해봤다는 것 자체로도 나에겐 너무 뜻깊은 경험이었다.
지금도 해당 이슈에는 새로운 댓글이 간혹 달리고 있다.
이들이 어떤 대화를 나누는지 한번씩 보는 것도 하나의 소소한 재미가 되었으며, 다시 한번 새삼스레 소통의 재미를 알게 되었다. (영어공부는 덤)
그럼 giscus 개발자님께서 무사히 휴가를 잘 보내고 오시길, 그리고 조속히 에러를 해결해 주시길 바라며 이만 마치도록 하겠다.
추가 글
2023.12.30
이 포스팅을 올리고, 자고 일어나니 댓글이 더 많이 쌓여있었다.
좋아요도 15개나 달려서 내 이슈로 누군가 도움을 받았다는 생각에 아침부터 매우 기분이 좋다.
그리고 새로 올라온 댓글 중 인상깊은 글 하나를 발견했다.
응답해주셔서 감사합니다. 서두르지 말고 즐거운 연휴 보내세요! 이 프로젝트는 내 사이트에 큰 도움이 되었기 때문에 스폰서 페이지에 작은 기부금을 넣었습니다. 이 글을 읽고 있는 누군가가 Giscus가 유용하다고 생각하고 약간의 잔돈이 있다면, 여러분도 그렇게 하시기를 바랍니다.
- yangdanny97
생각해보면, 모처럼 연말에 휴가를 갔는데 갑자기 장애 터졌다고 이슈 올라오면 얼마나 짜증나겠는가.. 나같으면 쉬고 있어도 마음 한구석이 불편했을 것이다. 개인 블로그에 댓글 안나오는게 뭐 급한일도 아닌데 얼른 휴가에서 돌아와서 고쳐주었으면 하는 생각만 가지고 있던 나 스스로 반성을 좀 하게 되었다.
사실 잘 사용하고 있던 서비스에 갑자기 장애가 터지면 많은 사람들도 나처럼 불만을 내뱉을 것이다. 그래도 저 댓글처럼 고생한 개발자에게 따뜻한 말 한마디와 지금까지 잘 사용해왔던 것에 대한 소소한 감사를 표한다면 더 좋은 개발 문화가 되지 않을까 하는 F적인 생각을 잠깐 하게 되었다.😅
2023.12.31
same here좀 그만올려..
요즘 밤만 되면 저 이슈에 달린 댓글 때문에 메일이 서너통씩 온다. 그런데 내용을 보면 다 ‘same here’ 라고만 적혀있다. 이미 위에서 개발자가 문제를 인지하고 있고 1월 2일 이후에 버그를 고치겠다고 말을 했는데도 말이다.
이것으로 깨달은게 하나 더 있다. 깃허브 이슈나 스택 오버플로우처럼 커뮤니티 형식으로 된 페이지에서 기술적인 해결방안을 찾을 땐, 중간에 이미 결론이 나와있지는 않은지 잘 찾아볼 것.😅