n8n 이메일 트리거가 메일을 받지 못할 때 해결하는 5가지 방법

n8n으로 자동화 워크플로우를 구성했는데, 정작 핵심인 이메일 트리거가 메일을 받지 못해 작업이 시작되지 않는 경험을 해보셨나요? 테스트 메일을 보냈는데도 반응이 없으면 설정을 잘못했는지, 계정 인증이 문제인지 혼란스럽기 마련입니다. 특히 Gmail, Outlook 같은 주요 이메일 서비스는 인증 방식이 엄격해서 초보자뿐 아니라 어느 정도 다뤄본 사용자도 실수하기 쉬운 영역입니다.

하지만 대부분의 n8n 이메일 트리거 오류는 몇 가지 패턴으로 수렴합니다. 아래 5가지 해결 방법을 순서대로 적용하면 흔한 원인을 빠르게 좁힐 수 있습니다. 복잡한 코드 수정 없이 워크플로우 설정과 계정 인증 정보를 점검하는 것만으로 해결되는 경우가 많으니, 각 항목을 차근차근 따라와 보세요.

1. 이메일 트리거가 침묵하는 이유: 인증 오류부터 시작하세요

가장 흔한 원인은 의외로 단순합니다. n8n에 연결된 이메일 계정의 인증 토큰이 만료되었거나, 서비스 제공업체의 보안 정책 변경으로 접근 권한이 해제된 경우입니다. 특히 Gmail의 경우 구글은 2022년부터 ‘Less secure apps’ 접근을 차단했고, OAuth 2.0 방식만 허용합니다. 따라서 한 달 전만 해도 정상이던 연결 정보가 갑자기 무효화될 수 있습니다. Google 계정의 ‘보안 > 타사 앱 연결’ 목록에서 n8n에 부여된 접근 권한이 유지되고 있는지도 확인해 보세요.

해결 방법은 간단합니다. n8n 대시보드에서 해당 이메일 계정의 크레덴셜을 삭제하고, 새로 연결(Reconnect)하여 권한을 재승인받으면 됩니다. 이때 수신함 읽기(read) 권한뿐 아니라, 트리거가 메일을 ‘삭제’하거나 ‘읽음’ 처리할 수 있는 범위(scope)까지 허용해야 합니다. 범위가 너무 좁으면 메일이 도착해도 이벤트가 감지되지 않을 수 있습니다.

추가로, n8n 실행(Execution) 탭에서 트리거 로그를 확인해 보세요. Invalid credentials (401) 또는 Token has been expired 메시지가 보인다면 크레덴셜 재발급이 우선입니다. 이 로그는 문제의 원인이 인증인지, 메일 전달인지 가려내는 기준이 됩니다.

2. Gmail 앱 비밀번호 설정: 2단계 인증이 원인일 수 있습니다

2단계 인증(2FA)을 활성화한 Gmail 계정은 일반 비밀번호로 n8n 이메일 트리거에 연결할 수 없습니다. 이때 필요한 것은 앱 비밀번호(App Password)입니다. 구글 계정의 ‘보안 > 2단계 인증 > 앱 비밀번호’ 경로에서 생성한 16자리 코드를 n8n의 SMTP/IMAP 호스트 정보와 함께 입력하면 됩니다. 다만 앱 비밀번호는 IMAP/SMTP 등 일부 프로토콜에서만 동작하며, Google Workspace 계정은 관리자 정책에 따라 사용이 제한될 수 있습니다.

실전 팁: Gmail 연동은 OAuth 2.0이 가장 안정적입니다. 앱 비밀번호는 빠르게 연결을 복구하기 위한 임시방편으로 쓰고, 시간이 된다면 n8n의 Gmail OAuth2 크레덴셜을 만들어 두는 것을 권장합니다.

Outlook(Outlook.com 또는 Microsoft 365) 사용자라면 아래 두 가지를 확인해 보세요.

• IMAP 설정 활성화: Outlook 웹 설정에서 ‘POP 및 IMAP’ 옵션이 켜져 있어야 합니다. 기본적으로 꺼져 있는 경우가 많습니다.
• 기본 인증 차단: Microsoft는 2024년 말부터 Microsoft 365 테넌트에서 기본 인증(Basic Auth)을 제거했습니다. 이 경우 OAuth 2.0 방식만 허용되므로 n8n에서 Microsoft 365 OAuth2 크레덴셜을 생성해야 합니다. 개인 Outlook 계정도 보안 설정에 따라 앱 암호가 필요할 수 있습니다.

3. 트리거 타입 변경: 웹훅이 아닌 폴링으로 전환하기

n8n의 이메일 트리거는 크게 특정 주기로 새 메일을 확인하는 폴링(Polling) 방식과, 메일 도착 즉시 이벤트를 받는 웹훅(Webhook/푸시) 방식으로 나뉩니다. Gmail Trigger 노드는 푸시 알림을, IMAP 기반 Email Trigger 노드는 폴링을 사용합니다. 문제는 일부 이메일 서비스가 아웃바운드 웹훅을 지원하지 않거나, n8n 서버의 방화벽·NAT 설정 때문에 외부 요청을 수신하지 못하는 상황에서 발생합니다.

이럴 때는 Gmail Trigger 노드에서 ‘Polling’ 방식을 선택하고, 수신 확인 주기를 1분에서 5분 사이로 조정해 보세요. 폴링 방식은 실시간성이 약간 떨어지지만, 어떤 호스팅 환경에서도 안정적으로 동작합니다. 특히 n8n을 직접 서버에 배포했다면 웹훅 수신을 위한 포트 개방 여부를 확인하는 대신 폴링을 사용하는 편이 확실합니다.

설정 경로를 예로 들면, n8n 에디터에서 Email Trigger(Node)를 선택 > Parameters 탭 > ‘Poll Times’에서 주기를 지정할 수 있습니다. 이때 ‘오프셋(Offset)’ 값이 현재 서버 시간과 동기화되어 있는지도 확인하세요.

4. 이메일 라우팅 및 스팸 필터: 메일이 지운 편지함에 있습니다

기술적인 문제가 없는데도 트리거가 반응하지 않는다면, 발신 메일이 실제 수신함에 도착했는지부터 확인하세요. 회사 메일의 경우 관리자 정책에 따라 자동으로 ‘보관함’이나 ‘프로모션’ 탭으로 분류될 수 있습니다. Gmail은 카테고리 탭별로 IMAP 폴더가 다르게 보일 수 있어, ‘받은 편지함(INBOX)’에 표시되지 않은 메일은 트리거가 감지하지 못할 가능성이 높습니다.

해결책은 두 가지입니다. 첫 번째는 Gmail 필터 설정에서 해당 발신자 주소나 특정 키워드가 포함된 메일을 ‘받은 편지함으로 이동’ + ‘중요 표시’로 강제하는 것입니다. 두 번째는 n8n에 연결된 이메일 계정의 웹 인터페이스에서 ‘스팸 신고’가 누적되어 발신자가 차단되었는지 확인하는 것입니다.

테스트 과정에서는 본인이 직접 보낸 메일이 자동으로 스팸 처리되지 않도록, 발신자 주소(보통 n8n의 SMTP 발신 주소)를 연락처에 추가해 두는 습관이 도움이 됩니다. 예를 들어 같은 Gmail 계정에서 보낸 메일도 필터 규칙이나 발신 평판에 따라 ‘프로모션’으로 분류될 수 있습니다.

5. 서버 시간대(Timezone)와 워크플로우 상태 점검

마지막으로, 트리거 설정이 정상이어도 워크플로우가 ‘비활성화(Inactive)’ 상태라면 실행되지 않습니다. 상단의 토글이 초록색으로 켜져 있는지 확인하세요. 그리고 n8n이 실행 중인 서버의 시간대(Timezone)를 점검해야 합니다. n8n 인터페이스에서 타임존을 ‘서울(Asia/Seoul)’로 설정했더라도, 작업자(Worker) 프로세스가 UTC 기준으로 실행 중이라면 폴링 주기가 어긋날 수 있습니다.

이를 해결하려면 환경 변수 TZ=Asia/Seoul를 n8n 컨테이너 또는 서비스 설정에 추가하고 완전히 재시작해야 합니다. Docker로 실행 중이라면 docker-compose.yml 파일의 environment 항목에 추가하는 것을 권장합니다. 특정 워크플로우만 문제가 된다면 연결된 에디터 노드가 끊어졌는지, 최근 실행 기록이 있는지도 함께 확인해 보세요.

결론: 로그를 두려워하지 말고, 차근차근 대응하세요

n8n 이메일 트리거 문제는 대부분 ‘설정 값’과 ‘환경’의 불일치에서 비롯됩니다. 위 5가지 방법을 모두 확인했는데도 해결되지 않는다면, n8n 실행(Execution) 탭의 로그에서 실제 트리거가 실행된 시점의 응답 코드를 살펴보세요. 연결 자체는 성공했는데 수신 메일이 ‘0건’으로 기록되어 있다면, 문제는 n8n이 아니라 메일 전달 경로(라우팅, 스팸 필터, IMAP 폴더)에 있을 가능성이 높습니다.

가장 확실한 방법 중 하나는 n8n 전용 Gmail 계정을 만들어 IMAP을 켜고, 수신함을 깨끗하게 유지한 채 사용하는 것입니다. 이렇게 하면 스팸 필터의 간섭을 줄이고 권한 문제도 최소화할 수 있습니다. 안내한 절차를 따라 설정한 뒤, 워크플로우를 저장하고 ‘활성화’ 상태에서 테스트 메일을 보내 정상 작동을 확인해 보시기 바랍니다.