Programmation
Guide pratique pour trouver la vraie cause, le fichier, la ligne, les avertissements et les erreurs bloquantes dans les journaux.
31 éléments
Structure du message
First error line
TypeError: Cannot read properties of undefinedLa première ligne d'erreur claire est souvent le meilleur point de départ.
Ignorez les journaux de suivi répétés au début et identifiez la première ligne qui indique l'échec.
TypeError: Cannot read properties of undefinedRechercher la première ligne d'erreur réelle dans ce journal.
Structure du message
Error name
SyntaxError, TypeError, ReferenceErrorLe nom de l'erreur vous indique la classe générale du problème.
Utilisez-le pour séparer les problèmes de syntaxe, d'exécution, de type, de réseau et d'environnement.
SyntaxError, TypeError, ReferenceErrorClasser cette erreur par nom d'erreur avant de suggérer une correction.
Structure du message
Error message
Module not found: Can't resolve '@/lib/error-message-guide'Le message explique ce que l'outil n'a pas pu faire.
Lire le verbe et l'objet : impossible de résoudre un module, impossible de lire une propriété ou impossible de lier un port.
Module not found: Can't resolve '@/lib/error-message-guide'Réécrire ce message d'erreur en coréen clair et indiquer la cause probable.
Structure du message
Stack trace
à SiteHeader (src/components/SiteHeader.tsx:42:15)Une liste d'appels de fonction qui ont conduit à l'erreur.
Rechercher la première ligne qui pointe vers votre fichier de projet, puis examiner cette zone.
La première ligne de la pile n'est pas toujours votre code. Certaines lignes sont des éléments internes du framework.
à SiteHeader (src/components/SiteHeader.tsx:42:15)Dans cette trace de pile, identifiez la première ligne provenant de mon projet.
Indices d'emplacement
File path
src/components/LanguageSwitcher.tsxLe chemin indique quel fichier l'outil pense être impliqué.
Privilégiez les chemins sous src, app, components ou lib avant d'examiner les dossiers de dépendances.
src/components/LanguageSwitcher.tsxLister les fichiers du projet mentionnés par cette erreur.
Indices d'emplacement
Line and column
src/app/page.tsx:27:12Ligne et colonne permettent de restreindre la position à une zone de caractères spécifique.
Inspectez la ligne mentionnée ainsi que quelques lignes au-dessus, car la cause réelle peut commencer plus tôt.
src/app/page.tsx:27:12Ouvrir le fichier autour de la ligne signalée et expliquer ce qui semble incorrect.
Indices d'emplacement
Project file line
src/lib/git-github.ts:143:7Une pile ou une ligne de construction qui pointe vers votre code source au lieu d'une dépendance.
Il s'agit généralement de la ligne à examiner avant de lire de longues traces de framework.
src/lib/git-github.ts:143:7Séparez les lignes de mon fichier de projet des lignes du framework.
Indices d'emplacement
node_modules line
node_modules/next/dist/server/app-render.jsUne ligne à l'intérieur d'un package de dépendance ou de framework installé.
Traitez-le comme un contexte, sauf si le journal indique également un problème de version de package ou de configuration.
N'éditez pas node_modules comme correction normale.
node_modules/next/dist/server/app-render.jsDites-moi si cette ligne de node_modules est la cause ou simplement un contexte.
Runtime JavaScript
SyntaxError
SyntaxError: Unexpected token '}'JavaScript ou TypeScript n'a pas pu analyser le code.
Vérifier les parenthèses, les guillemets, les virgules, les balises JSX et les expressions incomplètes à proximité de la ligne signalée.
SyntaxError: Unexpected token '}'Rechercher le problème de syntaxe autour de cette ligne.
Runtime JavaScript
TypeError
TypeError: Cannot read properties of undefinedUne valeur n'avait pas la forme ou le comportement attendu par le code au moment de l'exécution.
Vérifiez si la valeur peut être indéfinie, nulle, une chaîne au lieu d'un objet, ou une fonction manquante.
TypeError: Cannot read properties of undefinedDéterminez d'où provient cette valeur indéfinie.
Runtime JavaScript
ReferenceError
ReferenceError: copy is not definedLe code a tenté d'utiliser un nom de variable ou de fonction qui n'est pas disponible dans cette portée.
Vérifier les importations, l'orthographe, la portée et si la variable est déclarée avant son utilisation.
ReferenceError: copy is not definedRechercher pourquoi ce nom n'est pas défini.
Runtime JavaScript
Cannot read properties of undefined
Impossible de lire les propriétés d'une valeur non définie (lecture de 'navLabel').Le code a tenté d'accéder à une propriété sur une valeur qui est indéfinie.
Vérifiez l'objet avant le point, comme copy, locale, params, ou le résultat d'une recherche dans une carte.
Impossible de lire les propriétés d'une valeur non définie (lecture de 'navLabel').Identifiez quelle valeur est indéfinie dans cette erreur.
Runtime JavaScript
is not a function
setOpenMenu n'est pas une fonctionLe code a tenté d'appeler quelque chose avec des parenthèses, mais la valeur n'est pas une fonction.
Vérifiez si un attribut, une importation, le résultat d'un hook, ou une méthode d'objet a le nom attendu.
setOpenMenu n'est pas une fonctionRechercher pourquoi cette valeur est appelée comme une fonction.
Next.js et web
Module not found
Module not found: Can't resolve '@/lib/error-message-guide'Le bundler n'a pas pu trouver le fichier ou le package nommé dans un import.
Vérifier que le fichier existe, que l'orthographe du chemin est exacte et que l'alias pointe vers le dossier attendu.
Module not found: Can't resolve '@/lib/error-message-guide'Vérifier le chemin d'importation et le chemin de fichier réel.
Next.js et web
Export not found
Export errorMessageGuideCopy doesn't exist in target moduleLe nom d'importation ne correspond à aucune exportation du fichier cible.
Comparer le nom importé avec le nom exact de la constante, de la fonction ou du type exporté.
Export errorMessageGuideCopy doesn't exist in target moduleRechercher le nom d'importation ou d'exportation incorrect.
Next.js et web
Hydration failed
Hydration failed because the server rendered HTML didn't match the clientLe code HTML généré côté serveur ne correspondait pas à ce que React affichait dans le navigateur.
Vérifier les valeurs spécifiques au navigateur, les dates, les valeurs aléatoires, le stockage local et l'état du thème utilisés pendant le rendu initial.
Hydration failed because the server rendered HTML didn't match the clientRechercher le décalage probable entre le rendu côté serveur et côté client.
Next.js et web
404 Not Found
GET /ko/reference/error-message-guide 404L'itinéraire ou le fichier demandé n'a pas pu être trouvé.
Vérifiez le dossier des routes, la fonction generateStaticParams, l'attribut link href, et le chemin de sortie statique exporté.
GET /ko/reference/error-message-guide 404Vérifiez pourquoi cette route renvoie une erreur 404.
Next.js et web
500 Internal Server Error
GET /ko 500Le serveur a reçu la requête mais a échoué lors de son traitement.
Consultez le journal du terminal de la même requête, et non seulement le code de statut du navigateur.
GET /ko 500Faire correspondre cette erreur 500 du navigateur avec l'erreur terminale qui l'a causée.
TypeScript et lint
Property does not exist on type
La propriété 'navLabel' n'existe pas sur le type 'string'.TypeScript indique que le type déclaré de la valeur ne comprend pas cette propriété.
Vérifiez si la valeur a le type correct, si elle a été indexée correctement, et si la forme des données a changé.
La propriété 'navLabel' n'existe pas sur le type 'string'.Expliquez pourquoi TypeScript pense que cette propriété n'existe pas.
TypeScript et lint
Type is not assignable
Le type 'string' ne peut pas être affecté au type 'Locale'.Une valeur est transmise à un endroit qui attend un type différent.
Comparer le type de valeur réel avec le type attendu nommé après 'to type'.
Le type 'string' ne peut pas être affecté au type 'Locale'.Afficher le type réel et le type attendu dans cette erreur.
TypeScript et lint
ESLint error
Le React Hook useEffect a une dépendance manquante.Une règle d'analyse statique a détecté du code qui peut être dangereux, incohérent ou contraire au style du projet.
Lire le nom de la règle et la ligne du fichier, puis décider si le code ou la liste des dépendances doivent être modifiés.
Le React Hook useEffect a une dépendance manquante.Expliquer cette erreur de lint et la corriger sans modifier le comportement.
Next.js et web
Build failed
La compilation a échoué.La construction de production n'a pas pu se terminer.
Défiler au-dessus du résumé et trouver la première erreur de compilation, de type, de lint ou de routage.
La compilation a échoué.À partir de ce journal de construction, identifiez la première erreur bloquante.
Terminal et système
EADDRINUSE
Error: listen EADDRINUSE: address already in use :::3001Le serveur a tenté d'utiliser un port déjà utilisé par un autre processus.
Arrêter l'ancien serveur ou exécuter le nouveau serveur sur un port différent.
Error: listen EADDRINUSE: address already in use :::3001Rechercher ce qui utilise ce port et suggérer la prochaine étape la plus sûre.
Terminal et système
ENOENT
ENOENT : fichier ou répertoire inexistant, ouverture de 'next.config.js'.Le processus a tenté d'ouvrir un fichier ou un dossier qui n'existe pas à cet emplacement.
Vérifier le répertoire de travail actuel, l'orthographe du nom de fichier, l'extension et les fichiers générés.
ENOENT : fichier ou répertoire inexistant, ouverture de 'next.config.js'.Vérifiez si ce fichier est manquant ou si la commande est exécutée depuis le mauvais dossier.
Terminal et système
Permission denied
Opération non autoriséeLe processus n'a pas la permission de lire, d'écrire ou d'exécuter la cible.
Vérifier les règles du bac à sable, les permissions des fichiers, les dossiers protégés et si une approbation est nécessaire.
Ne corrigez pas les erreurs de permission en modifiant globalement les permissions, sauf si vous comprenez la cible.
Opération non autoriséeExpliquez pourquoi cette erreur de permission s'est produite et quelle approbation est nécessaire.
Terminal et système
Command not found
zsh: command not found: nextLe shell ne trouve pas de commande exécutable avec ce nom.
Vérifiez si les dépendances sont installées, si les scripts npm doivent être utilisés, et si PATH est défini.
zsh: command not found: nextDites-moi si je devrais exécuter un script npm au lieu de cette commande.
Ordre de débogage
Warning
DeprecationWarning: module.register() is deprecatedUn avertissement indique qu'une action peut nécessiter une attention, mais qu'elle peut ne pas interrompre la commande en cours.
Vérifiez si la commande s'est toujours exécutée avec succès avant de considérer l'avertissement comme une erreur.
DeprecationWarning: module.register() is deprecatedSéparez les erreurs bloquantes des avertissements non bloquants dans cette sortie.
Ordre de débogage
DeprecationWarning
DeprecationWarning: module.register() is deprecatedUne fonctionnalité qui fonctionne actuellement mais qui est prévue pour être remplacée ou supprimée ultérieurement.
Si la compilation réussit, enregistrez-la comme une action de suivi, sauf si elle fait référence à votre code ou à une mise à niveau requise.
DeprecationWarning: module.register() is deprecatedDites-moi si cet avertissement de dépréciation DeprecationWarning bloque le déploiement.
Ordre de débogage
Recent change
L'erreur a commencé après la modification de SiteHeader.tsxLa modification la plus récente et la plus pertinente est souvent l'indice le plus précieux.
Comparer l'emplacement de l'erreur avec les fichiers modifiés dans la tâche actuelle.
L'erreur a commencé après la modification de SiteHeader.tsxComparer cette erreur avec les fichiers modifiés le plus récemment.
Ordre de débogage
Reproduce step
Ouvrir /ko, cliquez sur le menu de la langue, puis cliquez sur le menu du siteLa séquence d'actions la plus courte qui fait réapparaître l'erreur.
Les étapes de reproduction claires permettent de vérifier que la correction fonctionne réellement.
Ouvrir /ko, cliquez sur le menu de la langue, puis cliquez sur le menu du siteTransformez cette description en étapes de reproduction précises.
Ordre de débogage
Minimal log
Ligne d'erreur + chemin du fichier + ligne de pile à partir de srcUn court ensemble de lignes de journal qui conserve la véritable erreur et l'emplacement.
Conservez la première erreur, le chemin du fichier du projet, la commande et le résumé final de réussite ou d'échec.
Ligne d'erreur + chemin du fichier + ligne de pile à partir de srcCompressez cette longue trace dans les lignes minimales nécessaires au débogage.