Meldungsstruktur
Erste Fehlerzeile
First error line
TypeError: Cannot read properties of undefined
Bedeutung
Die erste klare Fehlermeldung ist oft der beste Ausgangspunkt.
Lesart
Ignorieren Sie zunächst wiederholte Folgelogmeldungen und identifizieren Sie die erste Zeile, die den Fehler benennt.
Beispiel
TypeError: Cannot read properties of undefinedAnfragebeispiel
Die erste echte Fehlerzeile in diesem Protokoll finden.
Meldungsstruktur
Fehlername
Error name
SyntaxError, TypeError, ReferenceError
Bedeutung
Der Fehlernamen gibt Ihnen die allgemeine Klasse des Problems.
Lesart
Verwenden Sie es, um Syntax-, Laufzeit-, Typ-, Netzwerk- und Umgebungsprobleme zu trennen.
Beispiel
SyntaxError, TypeError, ReferenceErrorAnfragebeispiel
Klassifizieren Sie diesen Fehler anhand des Fehler-Namens, bevor Sie eine Lösung vorschlagen.
Meldungsstruktur
Fehlermeldung
Error message
Module not found: Can't resolve '@/lib/error-message-guide'
Bedeutung
Die Meldung erklärt, was das Tool nicht tun konnte.
Lesart
Lesen Sie das Verb und das Objekt: ein Modul konnte nicht aufgelöst, eine Eigenschaft konnte nicht gelesen oder ein Port konnte nicht gebunden werden.
Beispiel
Module not found: Can't resolve '@/lib/error-message-guide'Anfragebeispiel
Formulieren Sie diese Fehlermeldung in einfachem Koreanisch und weisen Sie auf die wahrscheinliche Ursache hin.
Meldungsstruktur
Stack-Trace
Stack trace
bei SiteHeader (src/components/SiteHeader.tsx:42:15)
Bedeutung
Eine Liste von Funktionsaufrufen, die zu dem Fehler geführt haben.
Lesart
Die erste Zeile finden, die auf Ihre Projektdatei verweist, und diesen Bereich untersuchen.
Hinweis
Die oberste Zeile im Stack ist nicht immer Ihr Code. Einige Zeilen sind interne Bestandteile des Frameworks.
Beispiel
bei SiteHeader (src/components/SiteHeader.tsx:42:15)Anfragebeispiel
Identifizieren Sie in dieser Stack-Trace die erste Zeile aus meinem Projekt.
Positionshinweise
Dateipfad
File path
src/components/LanguageSwitcher.tsx
Bedeutung
Der Pfad gibt an, welche Datei das Tool für relevant hält.
Lesart
Bevorzugen Sie Pfade unter src, app, components oder lib, bevor Sie Ordner mit Abhängigkeiten prüfen.
Beispiel
src/components/LanguageSwitcher.tsxAnfragebeispiel
Listen Sie die Projektdateien auf, die von diesem Fehler erwähnt werden.
Positionshinweise
Zeile und Spalte
Line and column
src/app/page.tsx:27:12
Bedeutung
Zeile und Spalte schränken den Ort auf einen bestimmten Zeichenbereich ein.
Lesart
Überprüfen Sie die angegebene Zeile sowie einige Zeilen darüber, da die eigentliche Ursache möglicherweise früher beginnt.
Beispiel
src/app/page.tsx:27:12Anfragebeispiel
Die Datei in der Nähe der angegebenen Zeile öffnen und erklären, was falsch erscheint.
Positionshinweise
Projektdateizeile
Project file line
src/lib/git-github.ts:143:7
Bedeutung
Eine Stack- oder Build-Zeile, die auf Ihren Quellcode anstelle einer Abhängigkeit verweist.
Lesart
Dies ist normalerweise die Zeile, die vor dem Lesen langer Framework-Protokolle untersucht werden sollte.
Beispiel
src/lib/git-github.ts:143:7Anfragebeispiel
Trennen Sie meine Projektdateizeilen von Framework-Dateizeilen.
Positionshinweise
node_modules line
node_modules line
node_modules/next/dist/server/app-render.js
Bedeutung
Eine Linie innerhalb eines installierten Abhängigkeits- oder Framework-Pakets.
Lesart
Behandeln Sie dies als Kontext, es sei denn, der Log weist auch auf ein Problem mit der Paketversion oder der Konfiguration hin.
Hinweis
Bearbeiten Sie keine Dateien im Verzeichnis node_modules als normale Korrektur.
Beispiel
node_modules/next/dist/server/app-render.jsAnfragebeispiel
Bitte teilen Sie mir mit, ob diese Zeile in der Datei node_modules die Ursache ist oder nur Kontextinformationen liefert.
JavaScript-Laufzeit
SyntaxError
SyntaxError
SyntaxError: Unexpected token '}'
Bedeutung
JavaScript oder TypeScript konnte den Code nicht parsen.
Lesart
Überprüfen Sie Klammern, Anführungszeichen, Kommas, JSX-Tags und unvollständige Ausdrücke in der Nähe der gemeldeten Zeile.
Beispiel
SyntaxError: Unexpected token '}'Anfragebeispiel
Das Syntaxproblem in der Nähe dieser Zeile finden.
JavaScript-Laufzeit
TypeError
TypeError
TypeError: Cannot read properties of undefined
Bedeutung
Ein Wert hatte nicht die erwartete Form oder das erwartete Verhalten zur Laufzeit.
Lesart
Überprüfen Sie, ob der Wert undefiniert, null, eine Zeichenkette anstelle eines Objekts oder eine fehlende Funktion sein kann.
Beispiel
TypeError: Cannot read properties of undefinedAnfragebeispiel
Verfolgen Sie, woher dieser undefinierte Wert stammt.
JavaScript-Laufzeit
ReferenceError
ReferenceError
ReferenceError: copy is not defined
Bedeutung
Der Code hat versucht, einen Variablennamen oder Funktionsnamen zu verwenden, der in diesem Gültigkeitsbereich nicht verfügbar ist.
Lesart
Überprüfen Sie Importe, Rechtschreibung, Gültigkeitsbereich und ob die Variable vor der Verwendung deklariert wurde.
Beispiel
ReferenceError: copy is not definedAnfragebeispiel
Finden, warum dieser Name nicht definiert ist.
JavaScript-Laufzeit
Kann keine Eigenschaften von undefiniertem Wert lesen.
Cannot read properties of undefined
Kann keine Eigenschaften von undefiniertem Wert lesen (Lesen von 'navLabel').
Bedeutung
Der Code hat versucht, auf eine Eigenschaft eines Werts zuzugreifen, der undefiniert ist.
Lesart
Überprüfen Sie das Objekt vor dem Punkt, z. B. copy, locale, params oder das Ergebnis einer Map-Abfrage.
Beispiel
Kann keine Eigenschaften von undefiniertem Wert lesen (Lesen von 'navLabel').Anfragebeispiel
Identifizieren Sie, welcher Wert in diesem Fehler undefiniert ist.
JavaScript-Laufzeit
ist keine Funktion
is not a function
setOpenMenu ist keine Funktion.
Bedeutung
Der Code hat versucht, etwas mit Klammern aufzurufen, aber der Wert ist keine Funktion.
Lesart
Überprüfen Sie, ob ein Prop, ein Import, ein Hook-Ergebnis oder eine Objektmethode den erwarteten Namen hat.
Beispiel
setOpenMenu ist keine Funktion.Anfragebeispiel
Finden, warum dieser Wert als Funktion aufgerufen wird.
Next.js und Web
Module not found
Module not found
Module not found: Can't resolve '@/lib/error-message-guide'
Bedeutung
Der Bundler konnte die Datei oder das Paket nicht finden, das in einem Import angegeben ist.
Lesart
Überprüfen Sie, ob die Datei existiert, ob die Rechtschreibung des Pfads korrekt ist und ob der Alias auf den erwarteten Ordner verweist.
Beispiel
Module not found: Can't resolve '@/lib/error-message-guide'Anfragebeispiel
Überprüfen Sie den Importpfad und den tatsächlichen Dateipfad.
Next.js und Web
Export nicht gefunden.
Export not found
Export errorMessageGuideCopy doesn't exist in target module
Bedeutung
Der Importname stimmt nicht mit einem Export aus der Zieldatei überein.
Lesart
Vergleichen Sie den importierten Namen mit dem exakten exportierten Namen der Konstanten, Funktion oder des Typs.
Beispiel
Export errorMessageGuideCopy doesn't exist in target moduleAnfragebeispiel
Den falsch geschriebenen Import- oder Exportnamen finden.
Next.js und Web
Hydration failed
Hydration failed
Hydration failed because the server rendered HTML didn't match the client
Bedeutung
Das vom Server generierte HTML entsprach nicht dem, was React im Browser gerendert hat.
Lesart
Überprüfen Sie browser-spezifische Werte, Datumsangaben, Zufallswerte, localStorage und den Theme-Status, die während des anfänglichen Renderings verwendet werden.
Beispiel
Hydration failed because the server rendered HTML didn't match the clientAnfragebeispiel
Die wahrscheinliche Diskrepanz zwischen Server- und Client-Rendering finden.
Next.js und Web
404 Not Found
404 Not Found
GET /ko/reference/error-message-guide 404
Bedeutung
Die angeforderte Route oder Datei konnte nicht gefunden werden.
Lesart
Überprüfen Sie den Routenordner, generateStaticParams, link href und den exportierten statischen Ausgabepfad.
Beispiel
GET /ko/reference/error-message-guide 404Anfragebeispiel
Überprüfen, warum diese Route einen 404-Fehler zurückgibt.
Next.js und Web
500 Internal Server Error
500 Internal Server Error
GET /ko 500
Bedeutung
Der Server hat die Anfrage erhalten, ist aber beim Verarbeiten fehlgeschlagen.
Lesart
Sehen Sie sich das Terminalprotokoll von derselben Anfrage an, nicht nur den Browser-Statuscode.
Beispiel
GET /ko 500Anfragebeispiel
Diese Browser-Fehlermeldung 500 mit dem Terminal-Fehler abgleichen, der sie verursacht hat.
TypeScript und lint
Die Eigenschaft existiert im angegebenen Typ nicht.
Property does not exist on type
Die Eigenschaft 'navLabel' existiert im Typ 'string' nicht.
Bedeutung
TypeScript sagt, dass der deklarierte Typ des Wertes dieses Attribut nicht enthält.
Lesart
Überprüfen Sie, ob der Wert den richtigen Typ hat, ob er korrekt indiziert wurde und ob sich die Datenstruktur geändert hat.
Beispiel
Die Eigenschaft 'navLabel' existiert im Typ 'string' nicht.Anfragebeispiel
Erläutern Sie, warum TypeScript denkt, dass diese Eigenschaft nicht existiert.
TypeScript und lint
Der Typ kann nicht zugewiesen werden.
Type is not assignable
Der Typ 'string' kann nicht dem Typ 'Locale' zugewiesen werden.
Bedeutung
Ein Wert wird an einen Ort übergeben, der einen anderen Typ erwartet.
Lesart
Vergleichen Sie den tatsächlichen Werttyp mit dem erwarteten Typ, der nach "to type" benannt ist.
Beispiel
Der Typ 'string' kann nicht dem Typ 'Locale' zugewiesen werden.Anfragebeispiel
Zeigen Sie den tatsächlichen Datentyp und den erwarteten Datentyp in diesem Fehler an.
TypeScript und lint
ESLint-Fehler
ESLint error
Der React Hook useEffect hat eine fehlende Abhängigkeit.
Bedeutung
Eine Regel für die statische Analyse hat Code gefunden, der möglicherweise unsicher, inkonsistent oder gegen den Projektstil verstößt.
Lesart
Lesen Sie den Regelnamen und die Zeile der Datei und entscheiden Sie dann, ob sich die Code- oder Abhängigkeitsliste ändern soll.
Beispiel
Der React Hook useEffect hat eine fehlende Abhängigkeit.Anfragebeispiel
Erklären Sie diesen Lint-Fehler und beheben Sie ihn, ohne das Verhalten zu ändern.
Next.js und Web
Der Build ist fehlgeschlagen.
Build failed
Kompilierung fehlgeschlagen.
Bedeutung
Der Produktionsbuild konnte nicht abgeschlossen werden.
Lesart
Scrollen Sie über die Zusammenfassung und finden Sie den ersten Compile-, Typ-, Lint- oder Route-Fehler.
Beispiel
Kompilierung fehlgeschlagen.Anfragebeispiel
Identifizieren Sie anhand dieses Build-Logs den ersten schwerwiegenden Fehler.
Terminal und System
EADDRINUSE
EADDRINUSE
Error: listen EADDRINUSE: address already in use :::3001
Bedeutung
Der Server hat versucht, einen Port zu verwenden, der bereits von einem anderen Prozess verwendet wird.
Lesart
Stoppen Sie den alten Server oder starten Sie den neuen Server auf einem anderen Port.
Beispiel
Error: listen EADDRINUSE: address already in use :::3001Anfragebeispiel
Finden, welcher Port verwendet wird, und den sichersten nächsten Schritt vorschlagen.
Terminal und System
ENOENT
ENOENT
ENOENT: Datei oder Verzeichnis nicht gefunden, Öffnen von 'next.config.js'.
Bedeutung
Der Prozess hat versucht, eine Datei oder einen Ordner zu öffnen, die/der an diesem Pfad nicht existiert.
Lesart
Überprüfen Sie das aktuelle Arbeitsverzeichnis, die Rechtschreibung des Dateinamens, die Erweiterung und die generierten Dateien.
Beispiel
ENOENT: Datei oder Verzeichnis nicht gefunden, Öffnen von 'next.config.js'.Anfragebeispiel
Überprüfen, ob diese Datei fehlt oder ob der Befehl aus dem falschen Ordner ausgeführt wird.
Terminal und System
Zugriff verweigert
Permission denied
Vorgang nicht erlaubt
Bedeutung
Der Prozess hat keine Berechtigung, die Zielressource zu lesen, zu schreiben oder auszuführen.
Lesart
Überprüfen Sie die Sandbox-Regeln, Dateiberechtigungen, geschützte Ordner und ob eine Genehmigung erforderlich ist.
Hinweis
Beheben Sie keine Berechtigungsfehler, indem Sie die Berechtigungen pauschal ändern, es sei denn, Sie verstehen das Ziel.
Beispiel
Vorgang nicht erlaubtAnfragebeispiel
Erläutern Sie, warum dieser Berechtigungsfehler aufgetreten ist und welche Genehmigung erforderlich ist.
Terminal und System
Befehl nicht gefunden
Command not found
zsh: command not found: next
Bedeutung
Die Shell kann keinen ausführbaren Befehl mit diesem Namen finden.
Lesart
Überprüfen Sie, ob die Abhängigkeiten installiert sind, ob npm-Skripte verwendet werden sollten und ob PATH gesetzt ist.
Beispiel
zsh: command not found: nextAnfragebeispiel
Sagen Sie mir, ob ich ein npm-Skript anstelle dieses Befehls ausführen sollte.
Debug-Reihenfolge
Warnung
Warning
DeprecationWarning: module.register() is deprecated
Bedeutung
Eine Warnung weist darauf hin, dass etwas möglicherweise Aufmerksamkeit erfordert, aber sie stoppt möglicherweise nicht den aktuellen Befehl.
Lesart
Überprüfen Sie, ob der Befehl weiterhin erfolgreich ausgeführt wurde, bevor Sie die Warnung als Fehler behandeln.
Beispiel
DeprecationWarning: module.register() is deprecatedAnfragebeispiel
Trennen Sie blockierende Fehler von nicht-blockierenden Warnungen in dieser Ausgabe.
Debug-Reihenfolge
DeprecationWarning
DeprecationWarning
DeprecationWarning: module.register() is deprecated
Bedeutung
Eine Funktion ist derzeit noch verfügbar, soll aber später ersetzt oder entfernt werden.
Lesart
Wenn der Build erfolgreich ist, protokollieren Sie dies als Folgemaßnahme, es sei denn, er verweist auf Ihren Code oder ein erforderliches Upgrade.
Beispiel
DeprecationWarning: module.register() is deprecatedAnfragebeispiel
Bitte teilen Sie mir mit, ob diese DeprecationWarning die Bereitstellung blockiert.
Debug-Reihenfolge
Jüngste Änderung
Recent change
Der Fehler trat nach der Bearbeitung von SiteHeader.tsx auf.
Bedeutung
Die letzte relevante Änderung ist oft der wertvollste Hinweis.
Lesart
Vergleichen Sie den Fehlerort mit den Dateien, die in der aktuellen Aufgabe geändert wurden.
Beispiel
Der Fehler trat nach der Bearbeitung von SiteHeader.tsx auf.Anfragebeispiel
Vergleichen Sie diesen Fehler mit den Dateien, die zuletzt geändert wurden.
Debug-Reihenfolge
Schritt wiederholen
Reproduce step
Öffnen /ko, klicken Sie auf das Sprachmenü und dann auf das Seitenmenü.
Bedeutung
Die kleinste Aktionssequenz, die den Fehler erneut verursacht.
Lesart
Klare Reproduktionsschritte ermöglichen es, zu überprüfen, ob die Korrektur tatsächlich funktioniert.
Beispiel
Öffnen /ko, klicken Sie auf das Sprachmenü und dann auf das Seitenmenü.Anfragebeispiel
Wandeln Sie diese Beschreibung in genaue Reproduktionsschritte um.
Debug-Reihenfolge
Minimaler Protokolleintrag
Minimal log
Fehlerzeile + Dateipfad + Stack-Trace aus der Quelldatei
Bedeutung
Eine kurze Menge von Protokollzeilen, die den tatsächlichen Fehler und den Ort beibehält.
Lesart
Behalten Sie den ersten Fehler, den Pfad zur Projektdatei, den Befehl und die abschließende Zusammenfassung des Erfolgs oder Misserfolgs.
Beispiel
Fehlerzeile + Dateipfad + Stack-Trace aus der QuelldateiAnfragebeispiel
Komprimieren Sie diesen langen Protokoll-Eintrag auf die minimal benötigten Zeilen, um das Debugging zu erleichtern.