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

Make 에러 메시지는 암호가 아니라 지도다.

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

첫 번째 관문: [400] Validation failed for parameter ‘…’ 👺

가장 흔하게 만나는 에러. 직역하면 ‘파라미터 검증 실패’. 시스템 구축 관점에서 이건 API 서버가 당신이 보낸 데이터를 보고 ‘이거 내가 원하는 형식이 아닌데?’ 라며 퇴짜 놓는 상황이다. 마치 자판기에 동전 넣는 곳에 지폐를 구겨 넣는 것과 같다. 자판기는 당연히 돈을 뱉어낸다.

❌ 흔한 실수: Notion의 ‘숫자’ 속성에 텍스트 값을 밀어 넣는다. 구글 시트 셀에 ‘1,000원’ 이라고 적어두고, 이 값을 그대로 Notion 숫자 속성에 매핑하는 식. 시스템 눈에는 ‘1,000원’은 숫자가 아니라 그냥 글자 덩어리다.

⚠️ 해결책: 데이터 타입을 강제로 변환시켜야 한다. Make에는 이런 용도의 내장 함수가 있다. 텍스트에서 숫자만 뽑아내려면 parseNumber() 함수를 쓰면 끝남.

• Before: {{1.price}} (값이 ‘1,000원’일 경우 에러)
• After: {{parseNumber(1.price)}} (값이 ‘1,000원’이어도 숫자 1000만 추출해서 넘김)

날짜 형식도 마찬가지. ‘2023-10-27’ 과 ‘Oct 27, 2023’은 사람 눈에나 같아 보이지, 시스템에겐 완전히 다른 값이다. formatDate() 함수로 형식을 통일시켜줘야 한다.

두 번째 관문: DataError: The value ‘…’ is not a valid number 🔢

이건 API 서버로 데이터를 보내기도 전에, Make 내부에서 터지는 에러다. ‘데이터 오류: 이 값은 유효한 숫자가 아님’. 즉, Make가 당신의 데이터를 다음 모듈로 넘기기 전에 자체 검수를 해보니, 숫자여야 할 곳에 이상한 값이 있다는 신호다. 연산을 하려는데 숫자가 아니라 빈 칸(null)이 들어올 때 주로 발생한다.

❌ 흔한 실수: 주문 수량과 단가를 곱해서 총액을 계산하는 모듈이 있다고 치자. 그런데 어떤 주문은 수량이 누락되어 빈 칸으로 들어왔다. ‘빈 칸’ x 1000원 = ? 수학적으로 성립이 안된다. 바로 시나리오가 멈춘다. 직장인 열에 아홉은 여기서 막힌다. 나도 그랬다.

⚠️ 해결책: 안전장치를 걸어야 한다. ‘만약 이 값이 비어있으면, 대신 0을 사용해’ 라는 규칙을 추가하면 된다. ifempty() 함수가 이 역할을 한다.

• Before: {{1.quantity}} * {{1.unit_price}} (quantity가 비어있으면 에러)
• After: {{ifempty(1.quantity; 0)}} * {{1.unit_price}} (quantity가 비어있으면 0으로 간주하고 계산을 이어감. 에러 안 남)

이거 하나면 ‘데이터가 들어올 수도 있고, 안 들어올 수도 있는’ 불안정한 파이프라인을 훨씬 안정적으로 만들 수 있다. 방어 코드의 기본이다.

세 번째 관문: [200] The scenario has been initialized ✅

이건 사실 에러가 아니다. 근데 초심자 입장에서는 가장 미치고 팔짝 뛸 노릇이다. 시나리오를 실행했는데, 초록불이 뜨며 성공했다고 나온다. 하지만 아무 일도 일어나지 않는다. 로그에는 ‘[200] 시나리오가 초기화되었습니다’ 라고 찍혀있다. 이게 무슨 말인가.

❌ 흔한 실수: ‘새로운 이메일이 오면 작동’하는 트리거를 설정해놓고, 테스트를 위해 ‘Run once’ 버튼을 누른다. 당연히 새로운 이메일이 없는 상태니, Make는 ‘새로운 데이터가 없어서 할 일이 없네. 일단 대기 상태로 있을게.’ 라는 뜻으로 [200] 코드를 띄운다. 이걸 에러로 착각하고 몇 시간씩 헤맨다.

⚠️ 해결책: 트리거가 작동할 ‘새로운’ 데이터를 직접 만들어줘야 한다. 이메일 트리거면 테스트 이메일을 보내고, 구글 시트 ‘새로운 행’ 트리거면 새 행을 직접 추가해야 한다. Make는 마지막으로 어디까지 읽었는지 기억하는 책갈피가 있다. 책갈피 이후에 새로운 내용이 없으면 당연히 읽을 게 없는 거다.

웹훅(Webhook) 트리거의 경우, 해당 웹훅 주소로 직접 테스트 데이터를 POSTMAN 같은 툴로 쏴줘야 시나리오가 정상적으로 데이터 구조를 인식하고 다음 단계로 넘어간다.

핵심 요약.

에러 메시지는 시스템이 보내는 구조 신호다. 이걸 무시하거나 두려워하면 파이프라인은 영원히 완성되지 않는다.

1. [400] Validation Failed: 보낼 데이터의 ‘형식’을 맞춰라. (parseNumber, formatDate)
2. DataError: 데이터가 ‘비어있을’ 가능성을 대비하라. (ifempty)
3. [200] Initialized: ‘새로운’ 데이터를 만들어서 테스트하라.

이 세 가지만 기억하면 된다. 그럼 3시간짜리 삽질이 3분 만에 끝난다.

PipeMaster-Lab 운영정책 및 제보 안내