Přeskočit na obsah

Build na serveru padá „Property 'x' does not exist" po změně Prisma schématu

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

Kanonický ruční řetěz (každý krok gatuje další):

Terminál
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/null

Jak 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 existenci BUILD_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í”
Přidal aiarchitekt.cz · 24. 9. 2026 2:00
Provozuje aiarchitekt.cz