Ako opraviť chybu „Prisma Client has not been generated yet“

Ak vaša aplikácia spadne s chybou Prisma Client has not been generated yet, najrýchlejšou užitočnou reakciou nie je všetko zmazať a naslepo preinštalovať. Najprv zistite, ktorý generátor Prisma Client váš projekt používa, vygenerujte klienta zo správnej schémy a uistite sa, že vaša aplikácia importuje z miesta, ktoré bolo skutočne vygenerované.

Existuje dôležitý zdroj zmätku súvisiaci s verziou. Podľa kontroly v septembri 2026 používa dokumentácia Prisma 7 generátor prisma-client s povinným výstupným adresárom output a kód aplikácie importuje Prisma Client z tejto vygenerovanej cesty. Staršie a stále bežné projekty používajú prisma-client-js, kde je @prisma/client bežným importom a vygenerované súbory špecifické pre projekt tradične žili v node_modules/.prisma/client. Miešanie týchto dvoch sád pokynov môže viesť k tomu, že máte vygenerovaného klienta na jednom mieste a kód aplikácie importuje z iného. Oficiálna príručka generovania Prisma Client dokumentuje aktuálne správanie Prisma 7.

Rýchla diagnostika: čo táto chyba zvyčajne znamená

1. Prečítajte si zlyhanie skôr, než zmeníte závislosti

Potvrdená časť je jednoduchá: Prisma Client je vygenerovaný kód prispôsobený vašej schéme. Ak runtime importuje vstupný bod klienta, ktorého vygenerovaná implementácia chýba, je zastaraná alebo nie je tam, kde ju import očakáva, spustenie môže zlyhať ešte pred prvým databázovým dotazom.

To, čo táto správa sama o sebe nepreukazuje, je, že vaša databáza je nedostupná, vaše prihlasovacie údaje sú nesprávne alebo že vaše migrácie zlyhali. Tieto stavy môžu spôsobiť iné chyby Prisma, ale táto konkrétna správa vás najprv nasmeruje na generovanie a rozlíšenie modulov.

Akcia: poznamenajte si presný balík, súbor a cestu importu v sledovaní zásobníka. Potom pred preinštalovaním čohokoľvek skontrolujte blok generátora v schéme.

2. Identifikujte svoj generátor a očakávanú cestu importu

Otvorte prisma/schema.prisma alebo cestu schémy nakonfigurovanú pre váš projekt. Generátor určuje, kde sa Prisma Client vytvára a ako ho máte importovať.

Aktuálny vzor prisma-client v Prisma 7

generator client {
  provider = "prisma-client"
  output   = "../generated/prisma"
}

Pri tomto vzore importujte z výstupu, ktorý ste nakonfigurovali, napríklad:

import { PrismaClient } from "../generated/prisma/client";

Aktuálna dokumentácia Prisma uvádza, že output je povinný pre generátor prisma-client v Prisma 7 a že importy pochádzajú z tohto vygenerovaného umiestnenia.

Starší vzor prisma-client-js

generator client {
  provider = "prisma-client-js"
}

V tomto staršom usporiadaní kód aplikácie bežne používa:

import { PrismaClient } from "@prisma/client";

Akcia: nemeňte import len preto, že nejaký návod používa iný generátor. Zosúlaďte import s vlastnou schémou a verziou.

3. Validujte schému a potom vygenerujte klienta

Pred generovaním validujte schému. Prisma poskytuje prisma validate špeciálne na kontrolu syntaxe a konfigurácie schémy. Oficiálna referencia prisma validate tiež podporuje --schema pre nepredvolené umiestnenia schémy.

npx prisma validate
npx prisma generate

Ak je vaša schéma inde:

npx prisma validate --schema=./packages/database/prisma/schema.prisma
npx prisma generate --schema=./packages/database/prisma/schema.prisma

Oficiálna referencia príkazu generate vysvetľuje, že Prisma skúma schému a zapisuje vygenerované artefakty do výstupu nakonfigurovaného generátorom.

Akcia: prečítajte si konečný výstup z prisma generate. Nepredpokladajte, kam boli súbory zapísané; použite cestu, ktorú Prisma hlási.

4. Overte, že výstup existuje tam, kde ho váš kód očakáva

Úspešný príkaz je nevyhnutný, ale runtime musí vidieť tie isté súbory. To je obzvlášť dôležité, keď nástroje zostavenia kopírujú len časť repozitára, keď fáza Dockeru vynechá vygenerovaný výstup alebo keď monorepo zostavuje jeden balík bez predchádzajúceho zostavenia databázového balíka.

Pre prisma-client preskúmajte vlastný adresár output zo schémy. Pre prisma-client-js preskúmajte usporiadanie nainštalovaného/vygenerovaného balíka Prisma používané vašou verziou. Nepovažujte priečinok zobrazený v staršom príklade za univerzálny.

Akcia: porovnajte tri veci vedľa seba: output generátora, cestu hlásenú príkazom prisma generate a príkaz importu v súbore, ktorý padá. Mali by opisovať toho istého vygenerovaného klienta.

5. Opravte import namiesto nekonečného regenerovania

Ak prisma generate zakaždým uspeje, ale tá istá chyba za behu pretrváva, opakované spúšťanie pravdepodobne nepomôže. Ďalšou otázkou je, či vaša aplikácia importuje vygenerovaný modul, ktorý ste práve vytvorili.

Pre generátor prisma-client v Prisma 7 aktuálna dokumentácia ukazuje importy z vlastnej vygenerovanej cesty. Pre projekt prisma-client-js je @prisma/client očakávaným importom balíka. Tento rozdiel je jedným z najčastejších dôvodov, prečo si aktuálne a staršie príklady zdanlivo odporujú.

Akcia: prehľadajte svoj repozitár a nájdite každý import PrismaClient. Pri migrácii alebo v monorepe môže byť jeden balík aktualizovaný, zatiaľ čo iný stále importuje starú cestu.

6. Skontrolujte verzie balíkov Prisma, keď bol projekt aktualizovaný

Nesúlad verzií je príčina závislá od okolností, nie niečo, čo táto chyba sama o sebe dokazuje. Príručky aktualizácie Prisma však vývojárom prikazujú aktualizovať balík CLI prisma aj @prisma/client pri prechode na hlavné verzie. Oficiálna príručka aktualizácie na Prisma 7 ukazuje aktualizáciu oboch balíkov spolu.

Skontrolujte, čo je skutočne nainštalované:

npm ls prisma @prisma/client

Pri pnpm alebo Yarn použite ekvivalentný príkaz na výpis pre pracovný priestor, ktorý vlastní Prisma. Ak projekt zámerne zostáva na Prisma 6 alebo inej podporovanej verzii, neaktualizujte len preto, aby ste odstránili túto správu. Zosúlaďte balíky s verziou, ktorú váš projekt očakáva, a potom regenerujte.

Akcia: ak sa verzie po zlúčení alebo aktualizácii závislostí stali nekonzistentnými, obnovte zamýšľané zodpovedajúce verzie a znova spustite prisma generate.

7. Začleňte generovanie do inštalácie alebo zostavenia

Keď aplikácia funguje na vývojárskom počítači, ale zlyhá po nasadení, chýbajúci krok je často v pipeline zostavenia, nie v kóde aplikácie. Dokumentácia na riešenie problémov Prisma pre Next.js konkrétne odporúča generovať Prisma Client pri každom nasadení, keď ukladanie závislostí do vyrovnávacej pamäte môže zabrániť tomu, aby sa generovanie pri inštalácii spustilo podľa očakávania.

Jednoduchý skript v package.json je:

{
  "scripts": {
    "postinstall": "prisma generate",
    "build": "prisma generate && next build"
  }
}

Zvyčajne potrebujete jeden spoľahlivý bod generovania, nie každý možný hook. Vyberte hook, ktorý vaša platforma nasadenia skutočne spúšťa. Pozrite si oficiálnu stránku na riešenie problémov s nasadením Next.js od Prisma pre prípad súvisiaci s vyrovnávacou pamäťou.

Akcia: preskúmajte protokoly CI a potvrďte, že prisma generate sa spustil po sprístupnení správnej schémy a závislostí a pred zbalením alebo spustením servera.

8. Po generovaní reštartujte proces

Vývojové servery, spúšťače testov a pracovné procesy môžu mať moduly načítané v pamäti. Vygenerovanie súborov na disk nezaručuje, že proces, ktorý už zlyhal pri importe, ich automaticky znova načíta.

Akcia: po úspešnom generovaní zastavte a reštartujte vývojový server, pracovný proces alebo testovací proces. Ak aplikácia teraz postúpi k inej chybe databázy alebo konfigurácie, je to užitočný dôkaz, že problém s generovaním klienta je vyriešený.

Monorepá: generujte v balíku, ktorý vlastní schému

V pracovnom priestore spustenie npx prisma generate z koreňa repozitára nie je automaticky ekvivalentné generovaniu vnútri databázového balíka. Vyhľadávanie schémy, konfiguračné súbory, závislosti a relatívne výstupné cesty sa môžu líšiť podľa balíka.

Oficiálna príručka Prisma pre pracovné priestory pnpm predvádza vyhradený databázový balík s vlastnou schémou, vygenerovaným klientom, pomocnými skriptami a exportmi pre spotrebiteľské aplikácie.

Praktický vzor je:

packages/database/
  prisma/schema.prisma
  generated/client/
  client.ts
  package.json

apps/web/
  package.json

Generujte z packages/database, exportujte klienta z tohto balíka a nechajte aplikácie závisieť od balíka namiesto zasahovania do súkromného vygenerovaného adresára iného pracovného priestoru.

Akcia: urobte úlohu zostavenia alebo generovania databázového balíka explicitnou závislosťou každej aplikácie, ktorá ho importuje.

Musíte zmazať node_modules?

Nie ako prvý krok. Zmazanie node_modules môže opraviť poškodenú inštaláciu, ale môže tiež skryť skutočný problém tým, že prinúti mnoho nesúvisiacich balíkov zmeniť sa naraz. Ak validácia schémy uspeje a generovanie hlási správny výstup, najprv overte importy, verzie balíkov a cesty zostavenia.

Čistá preinštalácia sa stáva rozumnou, keď sú metadáta balíkov nekonzistentné, vygenerovaný výstup je po zmenách závislostí zjavne zastaraný alebo váš správca balíkov hlási problémy s inštaláciou.

Akcia: pred čistením zachyťte npm ls prisma @prisma/client a výstup prisma generate. To vám dá dôkazy na porovnanie po preinštalovaní.

Čo vám táto chyba nehovorí

• Sama o sebe nedokazuje, že vaša databáza je nedostupná. Najprv opravte generovanie/rozlišenie importov a potom vyhodnoťte akúkoľvek zostávajúcu chybu pripojenia.
• Nedokazuje, že chýbajú migrácie. Generovanie Prisma Client a migrácia schémy databázy sú súvisiace pracovné postupy, ale nie sú tou istou operáciou.
• Neznamená, že každý projekt by mal importovať z @prisma/client. To závisí od generátora a verzie Prisma.
• Neznamená, že preinštalovanie závislostí je vždy potrebné. Správne prisma generate plus správna cesta importu často stačí.

Kontrolný zoznam prevencie

• Spustite prisma validate, keď sa zmení schéma alebo konfigurácia generátora.
• Spustite prisma generate po zmenách schémy a po stiahnutí zmien, ktoré ovplyvňujú API vygenerovaného klienta.
• Udržujte import za behu zosúladený s nakonfigurovaným výstupom generátora.
• Udržujte verzie prisma a @prisma/client zosúladené, keď vaša zvolená verzia Prisma používa oba balíky.
• V CI a produkcii spúšťajte generovanie explicitne pred zostavením/spustením, keď by ukladanie závislostí do vyrovnávacej pamäte mohlo spôsobiť jeho preskočenie.
• V monorepách generujte v pracovnom priestore, ktorý vlastní schému, a sprístupnite klienta prostredníctvom stabilnej hranice balíka.
• Po vygenerovaní predtým chýbajúceho klienta reštartujte dlho bežiace vývojové procesy.

Zrnutie

Spoľahlivá oprava je krátky reťazec dôkazov: identifikujte svoj generátor Prisma, validujte zamýšľanú schému, vygenerujte klienta, overte skutočnú výstupnú cestu a zosúlaďte svoj import s týmto výstupom. Ak sa problém vyskytuje len v CI alebo produkcii, presuňte ten istý krok generovania do pracovného postupu zostavenia. Ak sa vyskytuje v monorepe, urobte generovanie zodpovednosťou balíka, ktorý vlastní schému.

Tento prístup je spoľahlivejší než opakované mazanie závislostí, pretože vám hovorí, ktorá vrstva bola nesprávna: výber schémy, generovanie, verzie balíkov, rozlíšenie importov alebo balenie pri nasadení.