HOME

Researcher’s Note

20년 차 IT 베테랑의
실전 AI 생존기

일상과 업무의 효율을 300% 끌어올리는
실전 AI 및 PC 활용 가이드를 제안합니다.

  • [초급] 판다스 KeyError, 이거 하나 모르면 반나절 그냥 날아감

    [초급] 판다스 KeyError, 이거 하나 모르면 반나절 그냥 날아감

    이게 중요하다. 데이터 전처리의 90%는 에러와의 싸움이다. 데이터 좀 만져보겠다고 판다스(Pandas) 라이브러리 임포트하고 엑셀 파일 하나 불러왔을 거다. 그리고 특정 열(column)을 선택하는 순간, 어김없이 터지는 붉은색 에러 메시지. ‘KeyError’. 직장인 열에 아홉은 여기서 첫 번째 멘탈 붕괴를 경험한다. 나도 그랬다. 이건 당신의 코딩 실력 문제가 아님. 데이터 파이프라인 설계에서 가장 흔하게 발생하는 오염 데이터 처리의…

  • [초급] 구글 시트 IMPORTRANGE #REF! 에러, 10초 만에 해결하는 법

    [초급] 구글 시트 IMPORTRANGE #REF! 에러, 10초 만에 해결하는 법

    결론부터 말한다. IMPORTRANGE 함수에서 #REF! 에러가 뜨는 건 99% 공식 오류가 아니다. 권한 문제다. 어제 오후, 외부 파트너사와 공유할 대시보드 시트를 만들다 이 문제로 30분을 날렸다. 단순한 문제인데, 처음 겪으면 꽤 당황스럽다. 마치 문은 있는데 열쇠가 없는 상황과 같다. 에러의 본질 💣 데이터를 가져올 시트(Source)와 데이터를 붙여넣을 시트(Destination)는 서로 다른 파일이다. 구글은 보안상 기본적으로 이…

  • [중급] ‘로그를 확인하세요’ 라는 멍청한 에러, 파이프라인 터졌을 때 원인 찾는 법 👨‍🔧

    [중급] '로그를 확인하세요' 라는 멍청한 에러, 파이프라인 터졌을 때 원인 찾는 법 👨‍🔧

    결론부터 말하자면, 저 ‘처리 중 오류’ 메시지는 시스템이 당신에게 보내는 비명이다. 어제 잘만 돌아가던 자동화 봇이 오늘 갑자기 입을 꾹 닫고 저런 메시지만 뱉어낼 때. 직장인 열에 아홉은 여기서 막힌다. 나도 그랬다. 이건 당신의 잘못이라기보단, 당신이 조립한 파이프라인 어딘가에 금이 갔다는 신호다. 중요한 건 ‘어디에’ 금이 갔는지 알려주지 않는다는 점이다. 마치 자동차 엔진 경고등 같다.…

  • [중급] 재피어 무한 루프, 이 코드 한 줄이면 해결된다

    [중급] 재피어 무한 루프, 이 코드 한 줄이면 해결된다

    결론부터 말한다. 이 원리 모르면 당신의 재피어(Zapier) 계정은 정지된다. 어느날 SNS 알림이 미친 듯이 울렸다. 똑같은 메시지가 1초에 수십 개씩. 재피어(Zapier)가 무한 루프에 빠져 내 소중한 태스크를 태워먹고 있었다. 이메일을 확인하니 ‘Zap Turned Off’ 경고 메일이 와 있었다. 등골이 오싹했음. (이런 끔찍한 일을 겪어선 안된다.) 무한 루프. 간단하다. A가 B를 바꾸면, 바뀐 B가 다시 A를…

  • [중급] Netlify 빌드 실패? 이 한 줄이면 99% 해결됨 (Node.js 버전 문제)

    [중급] Netlify 빌드 실패? 이 한 줄이면 99% 해결됨 (Node.js 버전 문제)

    결론은, Node.js 버전 문제다. 어제 새벽 3시까지 이것 때문에 멘탈 나갈 뻔했다. 로컬에서는 멀쩡하게 돌아가던 프로젝트가 Netlify에만 올리면 귀신같이 빌드 실패. 로그를 까봐도 속 시원한 답은 안 나온다. 대부분 이런 메시지만 뱉어낼 거다. Error running command: Build script returned non-zero exit code: 1 Failed during stage ‘building site’: Build script returned non-zero exit code: 1…

  • [초급] Git push rejected non-fast-forward? 이 명령어 한 줄이면 5초컷

    [초급] Git push rejected non-fast-forward? 이 명령어 한 줄이면 5초컷

    이 에러는 당신의 로컬 저장소와 원격 저장소의 역사가 서로 달라졌다는 신호다. 자동화 스크립트 하나 고치고 푸시하려는데 이 붉은 글씨가 터졌다. ‘git push rejected non-fast-forward’. 피곤한데 진짜 짜증 나는 순간임. 쉽게 말해, 내가 로컬에서 작업하는 동안 다른 누군가, 혹은 다른 시스템이 원격 저장소(origin)에 먼저 새로운 커밋을 밀어 넣은 상태다. 기차로 비유하면, 내 기차(로컬)가 출발하기 전에 이미…

  • [초급] Gemini CLI 로그인 403 에러, 30분 삽질하고 알아낸 인증의 본질

    [초급] Gemini CLI 로그인 403 에러, 30분 삽질하고 알아낸 인증의 본질

    결론부터 말한다. `gcloud auth application-default login` 이 명령어 하나면 끝날 줄 알았다. 착각이었다. 지난 주말, 로컬 환경에서 Gemini API 연동 테스트를 하다가 아주 기본적인 인증 단계에서 막혔다. 터미널에 선명하게 찍히는 에러 메시지는 이거였다. PermissionDenied: 403 The caller does not have permission API는 분명히 켜져 있는데 권한이 없다는 말. 구글 클라우드(GCP) 좀 만져봤다는 사람들도 여기서 멘탈…

  • [초급] 당신의 자동화가 새벽 3시에 멈추는 진짜 이유 (feat. 에러코드)

    [초급] 당신의 자동화가 새벽 3시에 멈추는 진짜 이유 (feat. 에러코드)

    결론부터 말하자면, 당신의 자동화 스크립트는 100% 터진다. 새벽 3시, 세상 모르고 자고 있는데 구글 시트에 데이터가 안 쌓이고 있다. 아침에 출근해서 확인하니 스크립트는 뻗어있고, 원인은 불명. 상상만 해도 끔찍하다. 이걸 겪어봐야 정신 차린다. 아마추어와 프로의 차이는 ‘실패하지 않는 시스템’을 만드는 게 아니다. 그런 건 세상에 없다. ‘실패를 어떻게 다루는가’에서 갈린다. 코드가 중간에 멈추는 상황, 이걸…

  • [초급] Make 시나리오 에러, 이 3개 모르면 당신 파이프라인은 멈춘다

    [초급] Make 시나리오 에러, 이 3개 모르면 당신 파이프라인은 멈춘다

    Make 에러 메시지는 암호가 아니라 지도다. 베테랑인 나도 이거 붙잡고 씨름할 때가 더러 있다. 구글 시트에서 데이터를 끌어와 Notion DB에 쓰는 간단한 시나리오. 그런데 특정 데이터만 들어오면 자꾸 멈췄다. 로그에 찍히는 건 ‘[400] Validation failed’. 이 메시지 하나. 원인 찾는데 3시간. 해결하는데 3분 걸렸다. 허탈함. 대부분의 초급 단계 에러는 이 3가지 유형 안에 다 들어있다.…

  • [초급] 노션(Notion)을 단순 메모장으로만 쓰는 당신에게 📝

    [초급] 노션(Notion)을 단순 메모장으로만 쓰는 당신에게 📝

    결론부터 말하자면, 노션은 ‘디지털 레고’다. 그런데 대부분 이 레고로 그냥 네모난 집 한 채 짓고 끝낸다. 즉, 단순 텍스트 문서 저장용으로만 쓴다는 말이다. 이건 명백한 자원 낭비임. 노션의 본질은 흩어진 정보를 조립해 나만의 ‘작업 관제탑’ 즉, 시스템을 구축하는 데 있다. 이걸 못하면 노션을 반도 못 쓰는 거다. 가장 흔하게 저지르는 실수 3가지. 직장인 열에 아홉은…