Astro import.meta.env inlinuje serverové secrety při buildu — build bez .env je tichá bomba
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Tři dny po nasazení hotfixu (který se těchto rout vůbec netýkal) začaly platební routy „objednávka výstavy/propagace” vracet HTTP 500
s hláškou „Chyba při vytváření platby”. Běžné objednávky fungovaly. Log: Error: Neither apiKey nor config.authenticator provided v new Stripe(...)
při načtení modulu, ne při volání.
Root cause
Sekce “Root cause”Routy měly na úrovni modulu:
const stripe = new Stripe(import.meta.env.STRIPE_SECRET_KEY);Astro/Vite import.meta.env.* nahrazuje hodnotou při buildu (i pro serverové, ne-PUBLIC proměnné, pokud jsou v .env v době buildu).
Hotfix se stavěl v izolovaném git worktree — čistém, bez .env → do distu se zkompilovalo doslova new Stripe(undefined).
Konstruktor vyhodí výjimku při importu → celý modul routy selže → 500 pro každý request. Proces přitom klíč v process.env měl
(ecosystem/dotenv), takže vše, co používalo lazy getStripe() nad process.env, běželo. Dřívější buildy z hlavního worktree naopak
inlinovaly živý secret do distu — druhý, tichý problém stejné příčiny.
Fix
Sekce “Fix”let _stripe: Stripe | null = null;export function getStripe() { if (!_stripe) _stripe = new Stripe(process.env.STRIPE_SECRET_KEY!); return _stripe;}// routaconst customer = await getStripe().customers.create(...)Build bez .env → dist bez undefined, secret není v artefaktu, chyba (pokud klíč chybí) nastane až při volání s jasnou hláškou.
Deploy gate: grep -rl 'new Stripe(undefined' dist musí být prázdný + E2E smoke POST /api/<routa> bez auth → 401 (modul se načte).