Das sind die Fehlschläge, die React2Static von allein erkennt, wenn ein Build kaputtgeht. Jeder Eintrag unten zeigt die echte Ausgabe von npm, Vite oder tsc, sodass Sie nach genau Ihrer Zeile suchen können — oder legen Sie Ihr Projekt in den Builder, dann sagt er Ihnen, welcher Fall vorliegt.
Paketnamen, Pfade und Größen in den Beispielen unten sind nur Beispiele — der Builder setzt dort die Werte aus Ihrem eigenen Projekt ein.
Was Sie sehen
error during build:
[vite]: Rollup failed to resolve import "react-router-dom" from "/home/project/src/App.tsx".
This is most likely unintended because it can break your application at runtime.Der Code importiert react-router-dom, aber es steht nicht in package.json und wurde deshalb nie installiert. Nimm es in dependencies auf oder entferne den Import. Das ist der häufigste Fehlschlag bei KI-generierten Projekten — auf dem Rechner, der den Code geschrieben hat, ist das Paket längst vorhanden.
Die Lösung
npm install react-router-domWas Sie sehen
npm error Missing script: "build"
npm error
npm error To see a list of scripts, run:
npm error npm runWir führen npm run build aus, und es gibt nichts auszuführen. Ergänze ein build-Skript — bei einem Vite-Projekt ist das "build": "vite build".
Die Lösung
{
"scripts": {
"build": "vite build"
}
}Was Sie sehen
src/components/PostCard.tsx:12:23 - error TS2339: Property 'title' does not exist on type 'Post'.
12 <h2>{post.title}</h2>
~~~~~Das Build-Skript führt vor dem Bundling tsc aus, und die Typprüfung ist fehlgeschlagen. Korrigiere die im Log genannte Datei, oder beschränke das Skript auf den Bundler: "vite build" statt "tsc && vite build".
Die Lösung
{
"scripts": {
"build": "vite build"
}
}Was Sie sehen
> [email protected] build
> vite build
sh: 1: vite: not foundDas Build-Skript ruft vite auf, aber es steht nicht in package.json und wurde deshalb nie installiert. Nimm es in devDependencies auf.
Die Lösung
npm install -D viteWas Sie sehen
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: [email protected]
npm error Found: [email protected]Zwei Pakete verlangen unvereinbare Versionen derselben Abhängigkeit. Wir haben die Installation bereits mit --legacy-peer-deps wiederholt, ohne Erfolg — die Versionen in package.json müssen von Hand angeglichen werden.
Was Sie sehen
npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/@shadcn%2fui-toast
npm error 404 '@shadcn/ui-toast@^1.0.0' is not in this registry.npm findet es nicht in der Registry. KI-Werkzeuge erfinden gelegentlich Paketnamen, und private Pakete sind von hier aus nicht erreichbar. Prüfe die Schreibweise in package.json, oder entferne die Abhängigkeit, wenn sie nirgends importiert wird.
Was Sie sehen
npm error code ETARGET
npm error notarget No matching version found for react@^19.9.0.Das Paket gibt es, diesen Versionsbereich aber nicht. Lockere die Angabe in package.json oder setze sie auf eine tatsächlich veröffentlichte Version.
Was Sie sehen
vite v5.4.10 building for production...
✓ 41 modules transformed.
✓ built in 1.24sDer Build selbst lief fehlerfrei durch, es gibt aber nichts einzusammeln. Wir sehen in dist/, build/ und out/ nach — prüfe, wohin deine Build-Konfiguration schreibt.
Was Sie sehen
▲ Next.js 14.2.5
✓ Compiled successfully
✓ Generating static pages (5/5)
Route (app) Size First Load JSnext build erzeugt standardmäßig eine Server-Anwendung in .next/. Ergänze output: "export" in next.config.js und baue erneut — dann landen einfache Dateien in out/, die wir einsammeln können. Serverseitige Funktionen (API-Routen, Server Actions, Bildoptimierung) überleben den Export nicht.
Die Lösung
// next.config.js
module.exports = {
output: 'export',
}Was Sie sehen
<--- Last few GCs --->
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memoryEin Build im Browser bekommt nur begrenzten Speicher, und dieses Projekt überschreitet ihn. Ungenutzte Abhängigkeiten und übergroße Assets zu entfernen hilft meist; andernfalls muss dieses Projekt auf deinem eigenen Rechner gebaut werden.
Was Sie sehen
npm error code EUNSUPPORTEDPROTOCOL
npm error Unsupported URL Type "workspace:": workspace:*package.json nutzt workspace:-Abhängigkeiten, die sich nur innerhalb des vollständigen Repositorys auflösen lassen. Lade nur die Anwendung selbst hoch und ersetze die workspace:-Verweise durch echte Versionsnummern.
Was Sie sehen
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE package: '[email protected]',
npm warn EBADENGINE required: { node: '>=22.0.0' },
npm warn EBADENGINE current: { node: 'v20.11.1' }
npm warn EBADENGINE }Eine Abhängigkeit fordert eine Node-Version, die diese Umgebung nicht bereitstellt. Lockere das engines-Feld, oder wechsle zu einer Paketversion, die aktuelles Node unterstützt.
Was Sie sehen
npm error code EAI_AGAIN
npm error network request to https://registry.npmjs.org/react failed, reason: getaddrinfo EAI_AGAIN registry.npmjs.orgDer Download ist mittendrin abgebrochen. Das ist meist vorübergehend — starte den Build einfach neu. Wo registry.npmjs.org blockiert ist, wird ein VPN gebraucht.
Legen Sie Ihre ZIP in den Builder. Er führt den echten Build in Ihrem Browser aus, und wenn etwas kaputtgeht, zeigt er auf die entscheidende Zeile, statt Ihnen das ganze Log zu reichen.
Builder öffnen