Node.js 24.20.0: fs.cp и symlink EEXIST в Windows — как проверить исход. Обратимый test/control, матрица состояний, stop-line и обезличенный пакет поддержки.
Короткий ответ и граница вывода
Если наблюдается ситуация «копирование дерева с символьной ссылкой завершается не тем состоянием назначения или ошибкой EEXIST», не начинайте с обновления настроек на рабочем устройстве. Официально подтверждённая граница здесь узкая: Node.js 24.20.0 исправил обработку symlink и EEXIST в fs.cp на Windows. Проведите опыт «временное дерево из файла, относительной symlink и заранее существующего назначения; два запуска fs.cp с force false» и отдельно контроль «копирование обычного файла в соседнее временное назначение с теми же flags». Такой тест отвечает только на намерение «почему fs.cp с symlink в Windows Node.js 24.20.0 возвращает EEXIST и как проверить безопасное копирование». Он не доказывает массовость симптома, качество всего выпуска, готовность приложения к публикации или причину любого похожего сбоя. До запуска запишите ожидаемые состояния и версию Node.js 24.20.0; после опыта верните исходное состояние.
Наблюдаемый симптом и измерительная таблица
Симптом считается воспроизводимым, когда заполнена таблица «run × source type × destination exists × error code × target content unchanged». Каждая строка должна соответствовать одному заранее названному состоянию, а не впечатлению «работает/не работает». Предмет проверки: копирование дерева с символьной ссылкой завершается не тем состоянием назначения или ошибкой EEXIST. Не объединяйте его с соседними проблемами сети, профиля, разрешений, рендера или автоматики. Если показатель нельзя получить без токенов, содержимого сообщений, персональных путей либо реальных аккаунтов, fixture нужно упростить. Пустое значение отмечается как неизвестное, а не превращается в удобное подтверждение гипотезы.
Изолированный test и независимый control
Test строится строго так: временное дерево из файла, относительной symlink и заранее существующего назначения; два запуска fs.cp с force false. Control выполняется отдельно: копирование обычного файла в соседнее временное назначение с теми же flags. Обе ветки получают одинаковые версии, locale, временной лимит и нейтральные синтетические данные. Сначала снимите A, затем один раз B, после cleanup повторите A2. Одновременная смена API, политики, устройства, формы входа и порядка событий уничтожает причинность. Запрещено переносить в стенд рабочие cookies, IP, сообщения, контакты, TLS-секреты, device identifiers или полный environment.
Порядок безопасного опыта
Шаг 1: зафиксируйте baseline и подтвердите boundary «Node.js 24.20.0 исправил обработку symlink и EEXIST в fs.cp на Windows». Шаг 2: выполните control «копирование обычного файла в соседнее временное назначение с теми же flags» и заполните только «run × source type × destination exists × error code × target content unchanged». Шаг 3: запустите test «временное дерево из файла, относительной symlink и заранее существующего назначения; два запуска fs.cp с force false» с конечным timeout. Шаг 4: удалите временные объекты, закройте процессы, listeners, окна или соединения и повторите A2. Шаг 5: сравните не скриншоты целиком, а заранее выбранные поля. Если A2 отличается от A, состояние загрязнено: остановитесь, очистите только тестовый профиль и не повторяйте B до восстановления baseline.
Дерево решения без догадок
Правило чтения результата: EEXIST возникает только на заявленном конфликте и target не меняется — граница подтверждена; control падает — проверяем права temp. Дополнительно различайте четыре исхода. Test совпал с документированной границей, а control чист — подтверждён узкий контракт. Оба падают — неисправен fixture или среда. Test не воспроизводится при чистом control — вывод остаётся неопределённым, это не «исправлено». A2 расходится с A — опыт оставил состояние. Ни один исход не разрешает заявлять популярность проблемы, переносить вывод на иной browser build, OEM, driver, managed policy или production traffic.
Красные флаги и stop-line
Жёсткое условие остановки: не включать force и не удалять существующее назначение до сохранения его fingerprint. Также прекращайте тест при запросе повышенных прав, появлении реальных пользовательских данных, невозможности закрыть ресурс, внешнем соединении вне заявленного fixture, бесконечном retry, crash без сохранённого минимального trace либо изменении системного default. Не лечите неясность отключением TLS validation, выдачей широкого permission, постоянным preference, длинным sleep или сбросом рабочего профиля. Безопасный нулевой вывод полезнее вымышленной причины.
Минимальный пакет для поддержки
Для воспроизведения достаточно набора: минимальное дерево, flags, error.code, before/after hashes и версия Node.js. Добавьте Moscow timestamp, точное имя release/build, одну таблицу A/B/A2 и ожидаемую boundary «Node.js 24.20.0 исправил обработку symlink и EEXIST в fs.cp на Windows». Удалите домашние пути, account names, hostname, содержимое контактов и сообщений, заголовки авторизации, IP, cookies, key material и полные дампы. Получатель должен суметь проверить один state transition без доступа к вашей базе или устройству. Если не может, пакет либо избыточен, либо не содержит нужной измеримой границы.
Протокол T17-13: самостоятельная практическая ценность
Этот URL отвечает на один самостоятельный вопрос: «почему fs.cp с symlink в Windows Node.js 24.20.0 возвращает EEXIST и как проверить безопасное копирование». Его неделимый паспорт: боль «копирование дерева с символьной ссылкой завершается не тем состоянием назначения или ошибкой EEXIST»; официальная граница «Node.js 24.20.0 исправил обработку symlink и EEXIST в fs.cp на Windows»; fixture «временное дерево из файла, относительной symlink и заранее существующего назначения; два запуска fs.cp с force false»; матрица «run × source type × destination exists × error code × target content unchanged»; независимый control «копирование обычного файла в соседнее временное назначение с теми же flags». Сначала выполняется test, затем применяется правило «EEXIST возникает только на заявленном конфликте и target не меняется — граница подтверждена; control падает — проверяем права temp», а при риске действует stop-line «не включать force и не удалять существующее назначение до сохранения его fingerprint». Результат не заменяется общим uptime, одной фотографией, exit code или фразой «после обновления стало лучше». Пакет ограничен полями «минимальное дерево, flags, error.code, before/after hashes и версия Node.js». После cleanup снова заполните одну строку baseline и подтвердите отсутствие оставшегося состояния. Именно связка уникальной боли, измерителя, контроля, дерева решения и права остановиться отличает T17-13 от соседних материалов про Node.js 24.20.0. Карточка наблюдения node-24200-fs-cp-symlink-eexist-windows: Node.js 24.20.0 исправил обработку symlink и EEXIST в fs.cp на Windows; копирование дерева с символьной ссылкой завершается не тем состоянием назначения или ошибкой EEXIST; временное дерево из файла, относительной symlink и заранее существующего назначения; два запуска fs.cp с force false; run × source type × destination exists × error code × target content unchanged; минимальное дерево, flags, error.code, before/after hashes и версия Node.js.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты и ссылки перепроверены. Реальные пользовательские данные не использовались.
Источники и проверка
- Node.js 24.20.0 release notes проверено 2026-08-29
- Node.js pull request #64353 проверено 2026-08-29
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.