Node.js 24.20.0: loader нормализует path до lookup. People-first диагностика: что измерить, как читать результат и когда не продолжать rollout.
Короткий ответ без обещания результата
Для проблемы «эквивалентные пути с dot-segments или разным URL encoding попадают в разные loader cache entries» не нужен общий совет обновить runtime. Сначала подтвердите change boundary: loader применяет нормализацию path до lookup. Затем используйте только «мини-ESM package и три эквивалентных specifier: прямой path, dot-segment и безопасно encoded variant» и сравните её с контрольной веткой «один canonical specifier импортируется дважды и должен дать один instance marker». Успех такого опыта доказывает поведение одной функции на одном стенде; он не доказывает совместимость приложения, рост скорости, отсутствие других ошибок или готовность немедленно менять production. Версию бинарника и ожидаемый класс результата запишите до первого запуска.
Карта симптома и различимые состояния
Симптом считается наблюдаемым, только когда заполнена матрица «raw specifier × normalized URL × hook count × module instance marker × error class». Не заменяйте значения словами «работает» или «сломано»: фиксируйте boolean state, error.name/error.code, event order, размер, fingerprint либо счётчик — в зависимости от этой темы. Исходная боль здесь узкая: эквивалентные пути с dot-segments или разным URL encoding попадают в разные loader cache entries. Похожий лог с другим lifecycle не является тем же результатом. Если хотя бы одно поле нельзя получить без секретов или production-данных, тест нужно перепроектировать, а не расширять доступ.
Сборка пары test и control
Test-ветка строится так: мини-ESM package и три эквивалентных specifier: прямой path, dot-segment и безопасно encoded variant. Control-ветка независимо повторяет «один canonical specifier импортируется дважды и должен дать один instance marker». Обе работают в отдельных временных каталогах или процессах, используют одинаковые публичные markers и конечный timeout. Перед B снимите A, после B верните A2. Нельзя менять одновременно версию Node.js, форму входа, платформенный флаг и порядок событий: иначе причина расхождения останется неизвестной. Любые ключи, cookies, реальные hostname, базы, пользовательские файлы и полный env исключаются.
Ход опыта и возврат baseline
Шаг 1: подтвердите версию 24.20.0 и пустое состояние fixture. Шаг 2: выполните control «один canonical specifier импортируется дважды и должен дать один instance marker» и сохраните только поля «raw specifier × normalized URL × hook count × module instance marker × error class». Шаг 3: запустите test «мини-ESM package и три эквивалентных specifier: прямой path, dot-segment и безопасно encoded variant» один раз, затем повторите с теми же входами. Шаг 4: удалите созданные объекты, закройте listener, worker, file handle или timer и повторите A2. Если A2 не совпал с A, не повторяйте B до бесконечности: сначала найдите оставшийся handle, cache entry или файл.
Дерево решения по четырём исходам
Основное правило чтения результата уже определено: эквиваленты сходятся к ожидаемой записи без лишнего instance — lookup нормализован; hook counts расходятся — case; encoded variant меняет файл — stop. Дополнительно различайте четыре класса. Test совпал с ожиданием и control чист — зафиксирована граница. Оба дают ошибку — сломан fixture или среда. Test не воспроизводится, а control чист — результат неопределён, не «исправлено». A2 расходится с A — состояние загрязнено. Ни один класс не даёт права утверждать массовость проблемы или переносить вывод на другой runtime, provider, filesystem либо network stack.
Красные флаги и право остановиться
Жёсткая stop-line этой статьи: не тестировать traversal за temp root и не разрешать произвольные file URLs. Также прекращайте работу при crash, зависании без timeout, выходе за temp root, неожиданном внешнем соединении, запросе повышенных прав, создании dump или невозможности закрыть ресурсы. Нельзя лечить неясный результат подавлением error listener, увеличением памяти, отключением проверки сертификата или запуском на живом трафике. Безопасный нулевой вывод лучше удобной выдуманной причины.
Пакет данных для воспроизведения
Минимальный пакет support состоит из: три specifiers, normalized URLs, hook counts и module marker без домашних путей. К нему добавьте Moscow timestamp, архитектуру, точный `node --version`, команду с несекретными флагами и таблицу A/B/A2. Удалите домашние пути, содержимое ключей и payload, реальные URL, authorization headers, IP, токены и сырые дампы. Получатель должен суметь повторить один edge case и проверить один error/state transition. Если для воспроизведения требуется рабочая база или пользовательский запрос, пакет не минимизирован.
Протокол T16-19: самостоятельная ценность
Этот материал не является вариантом соседней статьи: его проверяемая боль — «эквивалентные пути с dot-segments или разным URL encoding попадают в разные loader cache entries», релизная граница — «loader применяет нормализацию path до lookup», а артефакт — «raw specifier × normalized URL × hook count × module instance marker × error class». Паспорт этой проверки неделим: намерение «как проверить path normalization перед loader lookup в Node.js 24.20.0 на эквивалентных URL»; изолированный стенд «мини-ESM package и три эквивалентных specifier: прямой path, dot-segment и безопасно encoded variant»; сравниваемый baseline «один canonical specifier импортируется дважды и должен дать один instance marker». Измерительная таблица для этого URL фиксирует именно «raw specifier × normalized URL × hook count × module instance marker × error class», поэтому её нельзя заменить общим uptime, одним exit code или замером памяти. Сначала создаётся «мини-ESM package и три эквивалентных specifier: прямой path, dot-segment и безопасно encoded variant»; затем отдельно выполняется «один canonical specifier импортируется дважды и должен дать один instance marker»; после этого применяется правило «эквиваленты сходятся к ожидаемой записи без лишнего instance — lookup нормализован; hook counts расходятся — case; encoded variant меняет файл — stop». Условие разворота также предметно: «не тестировать traversal за temp root и не разрешать произвольные file URLs». Пакет для разбора ограничен полями «три specifiers, normalized URLs, hook counts и module marker без домашних путей»; всё остальное не нужно для решения этой боли. После завершения удалите fixture и убедитесь, что процесс не оставил объекты из этого протокола. Именно эта связка боли, fixture, матрицы, control, stop-line и пакета поддержки, а не название Node.js, создаёт самостоятельную практическую ценность URL.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты и ссылки перепроверены. Реальные пользовательские данные не использовались.
Источники и проверка
- Node.js 24.20.0 release notes проверено 2026-08-29
- Node.js pull request #63917 проверено 2026-08-29
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.