Server: EnvError

Thrown when a required environment variable is missing or malformed.

Always has status: 500 — environment errors are server-side configuration issues.

Parameters

• source

  (Required)

  Always `"@supabase/server"`.

• code

  (Required)

  Machine-readable error code.

• hint

  (Optional)

  Actionable next step, when one applies.

• docs

  (Required)

  Documentation URL for this error's `code`.

• details

  (Optional)

  Structured, non-sensitive diagnostics — accepted auth modes, which credential headers were present, configured key *names*, JWT header fields. Never key values or token payloads.

• status

  (Required)

  Always `500` — environment errors are server-side issues.

Examples

Catching an EnvError

import { EnvError } from '@supabase/server'

try {
  const client = createAdminClient()
} catch (e) {
  if (e instanceof EnvError) {
    console.error(`[${e.code}] ${e.message}\n${e.hint}`)
    // → "[MISSING_SUPABASE_URL] [@supabase/server] SUPABASE_URL is required but not set."
    //   "Set SUPABASE_URL to your project URL (https://<project-ref>.supabase.co), …"
  }
}