cloudflare-hyperdrive

Status : Production Ready ✅ Last Updated : 2026-01-09 Dependencies : cloudflare-worker-base (recommended for Worker setup) Latest Versions : wrangler@4.58.0, pg@8.16.3+ (minimum), postgres@3.4.8, mysql2@3.16.0 Recent Updates (2025) : Save the id value - you'll need it in the next step! Add to your wrangler.jsonc : CRITICAL: PostgreSQL with node-postgres (pg): MySQL with mysql2: That's it! Your Worker now connects to your existing database via Hyperdrive with: This skill prevents 11 documented issues with sources and solutions. Error : Connection fails with hostname like xxx.hyperdrive.local Source : GitHub Issue #11556 Platforms : Windows, macOS 26 Tahoe, Ubuntu 24.04 LTS (wrangler@4.54.0+) Why It Happens : Hyperdrive local proxy hostname fails to resolve on certain platforms Prevention : Use environment variable for local development: Or use wrangler dev --remote (caution: uses production database) Status : Open issue, workaround available Error : Connection hangs indefinitely with no error message Source : GitHub Issue #6179 Why It Happens : Using IP address instead of hostname in connection string causes postgres.js to hang Prevention : Additional Gotcha : Miniflare (local dev) only supports A-z0-9 characters in passwords, despite Postgres allowing special characters. Use simple passwords for local development. Error : "unsupported authentication method" Source : GitHub...