Skip to content
← Back to activity

Immutable solution version

InvalidArgumentError: invalid upgrade header

Version 1Sign in to save

Complete solution

How to fix 'InvalidArgumentError: invalid upgrade header' in Neon, straight from the verified resolution in gh:neondatabase/serverless#7. Root cause plus what to change.

What was reported

Issue neondatabase/serverless#7 (closed, 6 comments): ## Steps to reproduce

  • clone https://github.com/bbigras/test-qwik-neon
  • npm install
  • replace "fake url" in src/routes/index.tsx by the connection string from neon.tech (ex: postgres://[email redacted]/neondb)
  • npm run dev
  • access YOUR_HOST

Is the connection string the right URL? invalid upgrade header sounds like a websocket error, so I'm wondering if I was supposed to use the connection string or maybe a URL for the proxy.

Expected result

Actual result

node:internal/deps/undici/undici:14152
    Error.captureStackTrace(err, this);

## The verified resolution

[jawj (maintainer)]: In Node there is no global WebSocket, so the driver falls back to the Cloudflare-style fetch-with-upgrade-header method, which fails with 'invalid upgrade header'. Fix: supply a WebSocket constructor  -  `neonConfig.webSocketConstructor = ws` (the `ws` package). Side note: forgetting the password in the connection string produced a cryptic error; newer driver versions emit a helpful message for that.

Evidence

Asked in gh:neondatabase/serverless#7 (https://github.com/neondatabase/serverless/issues/7): InvalidArgumentError: invalid upgrade header. The issue report: Issue neondatabase/serverless#7 (closed, 6 comments): ## Steps to reproduce

  • clone https://github.com/bbigras/test-qwik-neon
  • npm install
  • replace "fake url" in src/routes/index.tsx by the connection string from neon.tech (ex: postgres://[email redacted]/neondb)
  • npm run dev
  • access YOUR_HOST

Is the connection string the right URL? invalid upgrade header sounds like a websocket error, so I'm wondering if I was supposed to use the connection string or maybe a URL for the proxy.

Expected result

Actual result

node:internal/deps/undici/undici:14152
    Error.captureStackTrace(err, this); The verified answer: [jawj (maintainer)]: In Node there is no global WebSocket, so the driver falls back to the Cloudflare-style fetch-with-upgrade-header method, which fails with 'invalid upgrade header'. Fix: supply a WebSocket constructor  -  `neonConfig.webSocketConstructor = ws` (the `ws` package). Side note: forgetting the password in the connection string produced a cryptic error; newer driver versions emit a helpful message for that.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_6wwgZPLtYn64YiIlUZVs7Q" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">InvalidArgumentError: invalid upgrade header <span>— Vectle</span></a>