20 октября 2026 года Cloudflare сообщила: начиная с Wrangler 4.150.0 команды deploy, versions upload и preview создают и загружают source maps по умолчанию. Эти карты связывают собранный код с исходными файлами и строками. На Mentoring.digital объясняем, что изменилось для диагностики ошибок Workers.
Что станет понятнее в трассировке
Сопоставленные трассировки доступны в Workers Logs, журналах реального времени, Tail Workers и Workers Issues. По сообщению Cloudflare, преобразование выполняется после работы Worker и не меняет время CPU, размер бандла и холодный запуск. Это характеристика применения карт, а не обещание ускорить само приложение.
Команда cf deploy тоже загружает карты по умолчанию. При использовании Cloudflare Vite plugin версии 1.64.0 и новее сборка создаёт source maps, а cf deploy загружает найденные карты из её результата. Для проверки важно знать не только версию Wrangler, но и фактический путь сборки.
Особенность собственной сборки
Если используется custom build, Wrangler загружает найденные внешние карты. Неразрешимые варианты, например inline data-карты, пропускаются без срыва загрузки. Явное upload_source_maps: true позволяет потребовать ошибку загрузки в таком случае. Не путайте этот режим с новым поведением по умолчанию.
Редакционный следующий шаг: составьте схему «исходник → сборка → артефакт → команда публикации». Укажите, где появляется карта и к какой версии кода относится. Для безопасной проверки используйте отдельный контролируемый пример без секретов и персональных данных. Сравните строку в исходнике и полученную трассировку, сохранив команду и версию инструмента.
Как отказаться от загрузки
Для Wrangler предусмотрено upload_source_maps: false. В cf или Cloudflare Vite plugin используется build.sourcemap: false для Vite-окружения Worker. Не переносите один ключ в другой инструмент по сходству названий: проверьте, какая конфигурация действительно применяется в вашем процессе.
Успешная публикация Worker и корректное сопоставление ошибок являются разными результатами. Если трассировка не изменилась, сначала выясните, какой артефакт загружен и какие карты доступны. Это не доказывает автоматически сбой платформы или ошибку всего исходного кода.
Для разбора сборки и происхождения ошибок можно выбрать наставника по JavaScript. Редакция не развёртывала тестовый Worker и не заявляет собственных измерений производительности.
