지식센터 / 레퍼런스

📐 n8n 노드 선택 표준 — Supabase 노드 금지 & HTTP Request 통일

# n8n 노드 선택 표준

> 등록일: 2026-02-20 | 등록 배경: bawee(2.4.8) → bizspring(2.8.3) 이식 시 Supabase 노드 typeVersion 충돌로 Publish 불가 경험

---

핵심 원칙

외부 서비스 연동은 전부 HTTP Request 노드로 통일한다.

---

Supabase 노드 사용 금지

⛔ n8n-nodes-base.supabase 사용 금지
✅ HTTP Request 노드 + AP-01 헤더 패턴으로 대체

금지 이유

대체 패턴 (HTTP Request + AP-01)

{
  "type": "n8n-nodes-base.httpRequest",
  "typeVersion": 4.2,
  "parameters": {
    "method": "GET",
    "url": "={{ $json.SB_URL }}/rest/v1/테이블명",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        { "name": "apikey",        "value": "={{ $json.sbKey }}" },
        { "name": "Authorization", "value": "=Bearer {{ $json.sbKey }}" },
        { "name": "Content-Type",  "value": "application/json" }
      ]
    },
    "sendQuery": true,
    "queryParameters": {
      "parameters": [
        { "name": "select", "value": "원하는 컬럼" },
        { "name": "필터키", "value": "=eq.{{ $json.값 }}" }
      ]
    }
  }
}

---

노드 선택 기준표

---

Supabase HTTP Request 패턴 모음

SELECT (GET)

GET {SB_URL}/rest/v1/{table}?select=col1,col2&filter=eq.value
Headers: apikey / Authorization: Bearer / Content-Type

INSERT (POST)

POST {SB_URL}/rest/v1/{table}
Headers: + Prefer: return=representation
Body: { "col1": "val1", "col2": "val2" }

UPDATE (PATCH)

PATCH {SB_URL}/rest/v1/{table}?id=eq.{id}
Headers: + Prefer: return=representation
Body: { "col1": "new_val" }

UPSERT (POST)

POST {SB_URL}/rest/v1/{table}
Headers: + Prefer: resolution=merge-duplicates,return=representation
Body: { "id": "...", "col1": "val1" }

---

관련 안티패턴

• AP-01: Supabase HTTP → apikey + Authorization: Bearer + Content-Type 3개 헤더 필수
• AP-02: Code 노드에서 fetch() 금지 → HTTP Request 노드
• AP-10: bawee(인프라) vs bizspring(서비스) 인스턴스 명시

---

*project_code: COMMON | tags: n8n, 개발표준, Supabase, HTTP Request*

관련 문서

이 문서를 참조하는 문서 (역링크)

• 없음

다른 표현: Markdown · JSON · 최종 갱신 2026-08-24