Программирование
Практический справочник по поиску причины, файла, строки, предупреждений и настоящих ошибок в логах.
31 пунктов
Структура сообщения
First error line
TypeError: Cannot read properties of undefinedПервая четкая строка с ошибкой часто является лучшей отправной точкой.
Игнорируйте повторяющиеся записи в журнале отслеживания, по крайней мере, сначала, и определите первую строку, которая указывает на сбой.
TypeError: Cannot read properties of undefinedНайдите первую реальную строку ошибки в этом журнале.
Структура сообщения
Error name
SyntaxError, TypeError, ReferenceErrorИмя ошибки указывает на общий класс проблемы.
Используйте это для разделения проблем, связанных с синтаксисом, временем выполнения, типами данных, сетью и средой.
SyntaxError, TypeError, ReferenceErrorКлассифицируйте эту ошибку по имени ошибки, прежде чем предлагать исправление.
Структура сообщения
Error message
Module not found: Can't resolve '@/lib/error-message-guide'Сообщение объясняет, что инструмент не смог сделать.
Считывайте глагол и объект: не удалось разрешить модуль, не удалось прочитать свойство или не удалось привязать порт.
Module not found: Can't resolve '@/lib/error-message-guide'Перефразируйте это сообщение об ошибке на простом корейском языке и укажите наиболее вероятную причину.
Структура сообщения
Stack trace
at SiteHeader (src/components/SiteHeader.tsx:42:15)Список вызовов функций, которые привели к ошибке.
Найдите первую строку, которая указывает на ваш файл проекта, затем изучите эту область.
Верхняя строка стека не всегда является вашим кодом. Некоторые строки - это внутренние компоненты фреймворка.
at SiteHeader (src/components/SiteHeader.tsx:42:15)В этой трассировке стека определите первую строку из моего проекта.
Подсказки места
File path
src/components/LanguageSwitcher.tsxПуть указывает, какой файл, по мнению инструмента, задействован.
Предпочитайте пути, расположенные в каталогах src, app, components или lib, прежде чем просматривать папки зависимостей.
src/components/LanguageSwitcher.tsxПеречислите файлы проекта, на которые ссылается эта ошибка.
Подсказки места
Line and column
src/app/page.tsx:27:12Строка и столбец сужают местоположение до определенной области символов.
Проверьте указанную строку и несколько строк выше, потому что реальная причина может быть раньше.
src/app/page.tsx:27:12Откройте файл в строке, где возникла проблема, и объясните, что кажется неправильным.
Подсказки места
Project file line
src/lib/git-github.ts:143:7Стек или строка сборки, указывающая на исходный код, а не на зависимость.
Обычно это строка, которую следует проверить, прежде чем читать длинные трассировки фреймворка.
src/lib/git-github.ts:143:7Разделение строк моего проекта от строк фреймворка.
Подсказки места
node_modules line
node_modules/next/dist/server/app-render.jsЛиния внутри установленной зависимости или пакета фреймворка.
Рассматривайте это как контекст, если в журнале также указана версия пакета или проблема конфигурации.
Не редактируйте папку node_modules как обычную правку.
node_modules/next/dist/server/app-render.jsСообщите мне, является ли эта строка из файла node_modules причиной проблемы или просто контекстом.
JavaScript runtime
SyntaxError
SyntaxError: Unexpected token '}'JavaScript или TypeScript не смогли проанализировать код.
Проверьте скобки, кавычки, запятые, теги JSX и неполные выражения рядом с указанной строкой.
SyntaxError: Unexpected token '}'Найдите проблему синтаксиса вокруг этой строки.
JavaScript runtime
TypeError
TypeError: Cannot read properties of undefinedЗначение не имело ожидаемой формы или поведения во время выполнения.
Проверьте, может ли значение быть неопределенным, null, строкой вместо объекта или отсутствующей функцией.
TypeError: Cannot read properties of undefinedОпределите, откуда берется это неопределенное значение.
JavaScript runtime
ReferenceError
ReferenceError: copy is not definedКод попытался использовать имя переменной или функции, которое недоступно в данном контексте.
Проверьте импорты, орфографию, область видимости и объявлена ли переменная перед ее использованием.
ReferenceError: copy is not definedНайдите причину, по которой эта переменная не определена.
JavaScript runtime
Cannot read properties of undefined
Невозможно прочитать свойства неопределенного значения (чтение 'navLabel')Код попытался получить доступ к свойству значения, которое не определено.
Проверьте объект перед точкой, например, copy, locale, params или результат поиска в карте.
Невозможно прочитать свойства неопределенного значения (чтение 'navLabel')Определите, какое значение является неопределенным в этой ошибке.
JavaScript runtime
is not a function
setOpenMenu не является функцией.Код попытался вызвать что-то с круглыми скобками, но значение не является функцией.
Проверьте, имеет ли параметр, импорт, результат хука или метод объекта ожидаемое имя.
setOpenMenu не является функцией.Найдите причину, по которой это значение вызывается как функция.
Next.js и web
Module not found
Module not found: Can't resolve '@/lib/error-message-guide'Сборщик не смог найти файл или пакет, указанный в импорте.
Проверьте, существует ли файл, правильность написания пути и указывает ли псевдоним на ожидаемую папку.
Module not found: Can't resolve '@/lib/error-message-guide'Проверьте путь импорта и фактический путь к файлу.
Next.js и web
Export not found
Export errorMessageGuideCopy doesn't exist in target moduleИмя для импорта не соответствует ни одному экспортируемому значению из целевого файла.
Сравните импортированное имя с точным именем экспортированной константы, функции или типа.
Export errorMessageGuideCopy doesn't exist in target moduleНайдите несовпадающее имя импорта или экспорта.
Next.js и web
Hydration failed
Hydration failed because the server rendered HTML didn't match the clientСгенерированный на сервере HTML не соответствовал тому, что React отображал в браузере.
Проверьте значения, используемые только в браузере, даты, случайные значения, localStorage и состояние темы, используемые во время начальной отрисовки.
Hydration failed because the server rendered HTML didn't match the clientНайдите вероятное несоответствие рендеринга на сервере и клиенте.
Next.js и web
404 Not Found
GET /ko/reference/error-message-guide 404Запрошенный маршрут или файл не найден.
Проверьте папку маршрутов, generateStaticParams, атрибут href и экспортированный статический путь вывода.
GET /ko/reference/error-message-guide 404Проверьте, почему этот маршрут возвращает ошибку 404.
Next.js и web
500 Internal Server Error
GET /ko 500Сервер получил запрос, но произошла ошибка при его обработке.
Просмотрите журнал терминала для того же запроса, а не только код состояния браузера.
GET /ko 500Сопоставьте эту ошибку браузера 500 с ошибкой терминала, которая ее вызвала.
TypeScript и lint
Property does not exist on type
Свойство 'navLabel' не существует в типе 'string'TypeScript сообщает, что объявленный тип значения не содержит этого свойства.
Проверьте, имеет ли значение правильный тип, правильно ли оно было индексировано и изменилась ли структура данных.
Свойство 'navLabel' не существует в типе 'string'Объясните, почему TypeScript считает, что этого свойства не существует.
TypeScript и lint
Type is not assignable
Тип 'string' не может быть присвоен типу 'Locale'.Значение передается туда, где ожидается другой тип данных.
Сравните фактический тип значения с ожидаемым типом, указанным после "to type".
Тип 'string' не может быть присвоен типу 'Locale'.Отображать фактический тип и ожидаемый тип в этой ошибке.
TypeScript и lint
ESLint error
В React Hook useEffect отсутствует зависимостьПравило статического анализа обнаружило код, который может быть небезопасным, непоследовательным или нарушающим стиль проекта.
Считывайте имя правила и строку из файла, а затем решайте, следует ли изменять код или список зависимостей.
В React Hook useEffect отсутствует зависимостьОбъясните эту ошибку линтера и исправьте ее, не меняя поведение.
Next.js и web
Build failed
Компиляция не удалась.Сборка для производственной среды не удалось завершить.
Прокрутите вверх, чтобы увидеть сводку, и найдите первую ошибку компиляции, типа, линтинга или маршрутизации.
Компиляция не удалась.Определите первую критическую ошибку в этом журнале сборки.
Терминал и система
EADDRINUSE
Error: listen EADDRINUSE: address already in use :::3001Сервер попытался использовать порт, который уже используется другим процессом.
Остановите старый сервер или запустите новый сервер на другом порту.
Error: listen EADDRINUSE: address already in use :::3001Найдите, что использует этот порт, и предложите следующий наиболее безопасный шаг.
Терминал и система
ENOENT
ENOENT: такого файла или каталога не существует, открыть 'next.config.js'.Процесс попытался открыть файл или папку, которые не существуют по этому пути.
Проверьте текущую рабочую директорию, правильность написания имени файла, расширение и сгенерированные файлы.
ENOENT: такого файла или каталога не существует, открыть 'next.config.js'.Проверьте, не отсутствует ли этот файл или выполняется ли команда из неправильной папки.
Терминал и система
Permission denied
Операция не разрешена.Процесс не имеет разрешения на чтение, запись или выполнение целевого файла.
Проверьте правила песочницы, разрешения файлов, защищенные папки и требуется ли разрешение.
Не исправляйте ошибки разрешений путем широкого изменения разрешений, если вы не понимаете целевую систему.
Операция не разрешена.Объясните, почему произошла эта ошибка разрешения и какое разрешение необходимо.
Терминал и система
Command not found
zsh: command not found: nextКомандная оболочка не может найти исполняемую команду с таким именем.
Проверьте, установлены ли зависимости, следует ли использовать сценарии npm и установлен ли PATH.
zsh: command not found: nextСообщите мне, следует ли мне запускать сценарий npm вместо этой команды.
Порядок отладки
Warning
DeprecationWarning: module.register() is deprecatedПредупреждение указывает на то, что что-то может потребовать внимания, но может не остановить текущую команду.
Проверьте, успешно ли завершилась команда, прежде чем рассматривать предупреждение как ошибку.
DeprecationWarning: module.register() is deprecatedРазделение блокирующих ошибок от некритических предупреждений в этом выводе.
Порядок отладки
DeprecationWarning
DeprecationWarning: module.register() is deprecatedФункция все еще работает сейчас, но планируется заменить или удалить ее позже.
Если сборка прошла успешно, зафиксируйте это как последующее действие, если только это не относится к вашему коду или необходимому обновлению.
DeprecationWarning: module.register() is deprecatedСообщите мне, блокирует ли это предупреждение DeprecationWarning развертывание.
Порядок отладки
Recent change
Ошибка началась после редактирования SiteHeader.tsxСамое последнее связанное изменение часто является наиболее ценной подсказкой.
Сравните местоположение ошибки с файлами, измененными в текущей задаче.
Ошибка началась после редактирования SiteHeader.tsxСравните эту ошибку с файлами, которые были изменены последними.
Порядок отладки
Reproduce step
Открыть /ko, нажмите на меню языка, затем нажмите на меню сайта.Наименьшая последовательность действий, которая вызывает повторное появление ошибки.
Четкие шаги воспроизведения позволяют убедиться, что исправление действительно работает.
Открыть /ko, нажмите на меню языка, затем нажмите на меню сайта.Преобразуйте это описание в точные шаги для воспроизведения.
Порядок отладки
Minimal log
Строка ошибки + путь к файлу + строка стека из srcКороткий набор строк журнала, сохраняющий фактическую ошибку и ее местоположение.
Сохраняйте первую ошибку, путь к файлу проекта, команду и краткое описание успеха или неудачи.
Строка ошибки + путь к файлу + строка стека из srcСжимайте этот длинный журнал в минимальное количество строк, необходимых для отладки.