Build na serveru padá „Property 'x' does not exist" po změně Prisma schématu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Přidáš sloupec do schema.prisma, lokálně prisma generate + tsc + testy projdou. Na serveru next build spadne:
Type error: Property 'userIds' does not exist on type '{ role: string; id: string; scope: string; updatedAt: Date; }'.Migrace přitom proběhla (sloupec v DB je). Gate buildu (BUILD_ID) správně zabránil swapu, produkce jela dál na starém buildu.
Root cause
Sekce “Root cause”Generovaný Prisma klient leží v repu mimo node_modules (src/generated/…) a je záměrně v rsync --exclude (server si ho generuje sám). Oficiální deploy.sh má krok npx prisma generate (+ --schema pro druhé schéma), ale ručně skládaný řetěz (rsync → migrate → build) ho vynechal. Typy na serveru tedy odpovídaly starému schématu.
Druhá past ve stejném dni: ruční řetěz vynechal i NODE_OPTIONS=--max-old-space-size=8192, které deploy.sh má → build spadl na OOM (SIGABRT ve worker procesu). Gate opět držel.
Fix
Sekce “Fix”Kanonický ruční řetěz (každý krok gatuje další):
rsync … (exclude .env*, /src/generated/, .next*) \ && node scripts/migrate-tenants.mjs --dry-run && node scripts/migrate-tenants.mjs \ && npx prisma generate && npx prisma generate --schema prisma/master/schema.prisma \ && NEXT_DIST_DIR=.next-build NODE_OPTIONS=--max-old-space-size=8192 npm run build \ && test -s .next-build/BUILD_ID \ && mv .next .next-old && mv .next-build .next && pm2 restart app --update-env \ && curl -fs http://127.0.0.1:PORT/login >/dev/nullJak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: v deploy logu chybí řádek
Generated Prisma Client; build chyba zmiňuje pole, které je v migraci z téhož commitu. - Anti-pattern: „jednorázový” ruční deploy poskládaný z paměti místo volání skriptu; generované artefakty v rsync exclude bez odpovídajícího generate kroku.
- Lepší přístup: jeden deploy skript se všemi kroky a
set -o pipefail; gate na existenciBUILD_ID; migrační skript bez--help= ostrý běh, proto vždy nejdřív--dry-run.
Sister bugs / související
Sekce “Sister bugs / související”- build-passes-locally-lint-fails-production — stejný vzor „lokálně zelené, server červený”.
- bash-err-trap-command-substitution — proč
| tailmaskuje exit kód buildu (pipefail).