HTTP Request node 자주 발생하는 문제

HTTP Request node 에서 자주 발생하는 오류와 문제, 그리고 이를 해결하거나 문제를 해결하기 위한 단계를 소개합니다. Bad request - 매개변수를 확인하세요 # 이 오류는 노드가 잘못된 요청을 나타내는 400 오류를 수신할 때 표시됩니다. 이 오류는 대부분 다음과 같은 이유로 발생합니다. Query Parameter 에서 잘못된 이름이나 값을 사용하고 있는 경우입니다. Query Parameter 에 배열 값을 전달하고 있지만 배열 형식이 올바르지 않은 경우입니다. Array Format in Query Parameters 옵션을 사용해 보세요. 쿼리 매개변수 형식을 지정하려면 사용 중인 서비스의 API 문서를 검토하세요. 요청한 리소스를 찾을 수 없음 # 이 오류는 입력한 엔드포인트 URL 이 유효하지 않을 때 표시됩니다. 이는 URL의 오타나 더 이상 사용되지 않는(deprecated) API 때문일 수 있습니다. 유효한 엔드포인트인지 확인하려면 사용 중인 서비스의 API 문서를 참조하세요. Connection refused (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 보다 먼저