HTTP Request node 자주 발생하는 문제

n8n 워크플로 자동화 플랫폼의 HTTP Request node에서 자주 발생하는 문제와 질문, 해결 방법을 설명합니다.

다음은 HTTP Request node 에서 자주 발생하는 오류와 문제, 그리고 해결 또는 문제 해결 단계입니다. 잘못된 요청 - 파라미터를 확인하세요 # 이 오류는 노드가 잘못된 요청을 나타내는 400 오류를 수신할 때 표시됩니다. 이 오류는 주로 다음과 같은 이유로 발생합니다: 쿼리 파라미터 에 잘못된 이름이나 값을 사용하는 경우. 쿼리 파라미터 에 배열 값을 전달하지만 배열 형식이 올바르지 않은 경우. 쿼리 파라미터의 배열 형식 옵션을 사용해보세요. 서비스의 API 문서를 참조하여 쿼리 파라미터를 올바르게 형식화하세요. 요청하는 리소스를 찾을 수 없습니다 # 이 오류는 입력한 엔드포인트 URL 이 유효하지 않을 때 표시됩니다. URL에 오타가 있거나 API가 더 이상 사용되지 않는 경우에 발생할 수 있습니다. 서비스의 API 문서를 참조하여 유효한 엔드포인트를 확인하세요. 연결이 거부되었습니다 (ECONNREFUSED) # 이 오류는 노드가 네트워크에서 호스트에 도달했지만 타깃 포트에 리스너가 없을 때 표시됩니다. TCP 연결이 능동적으로 거부됩니다. DNS 실패, 타임아웃, 방화벽 차단이 아닙니다. 셀프 호스팅 n8n에서 가장 일반적인 원인은 Docker 네트워킹입니다. n8n 컨테이너 내부에서 localhost 와 127.0.0.1 은 호스트 머신이 아닌 컨테이너 자체를 가리킵니다. 노드에서 http://localhost:5000 으로 요청하면 아무것도 리스닝하지 않는 n8n 컨테이너의 포트 5000으로 요청이 전달됩니다. 해결하려면 컨테이너가 라우팅할 수 있는 이름으로 타깃을 지정하세요: 호스트 머신의 타깃, Docker Desktop (Mac 또는 Windows) : URL 필드에 http://host.docker.internal:<port> 를 사용하세요. Docker Desktop은 이 호스트명을 자동으로 추가합니다. 호스트 머신의 타깃, Linux : 컨테이너에 --add-host=host.docker.internal:host-gateway 를 전달하거나 docker-compose.yml 에 extra_hosts 를 설정하세요: services: n8n: image: docker.n8n.io/n8nio/n8n extra_hosts: - "host.docker.internal:host-gateway" 동일한 수정 방법이 MySQL node 에도 문서화되어 있습니다. 같은 Compose 스택의 다른 컨테이너에 있는 타깃 : 서비스 이름을 호스트명으로 사용하세요. 예: http://my-api:5000 . 게시된 ports: 매핑이 아닌 컨테이너의 내부 포트를 참조하세요. Docker 외부에서도 Node.js 17 이상에서 별도의 원인이 나타납니다: localhost 가 127.0.0.1 보다 먼저 IPv6 주소 ::1 로 확인됩니다. 타깃이 127.0.0.1 에만 바인딩된 경우 IPv6 시도가 거부되고 HTTP Request node 내부에서 IPv4로의 폴백이 항상 성공하지는 않습니다. localhost 대신 U