В ночь на 21 ноября по Москве вышел PyYAML 6.0.4. Главное в нём: исправили уязвимость, из-за которой небольшой YAML-документ с ключами слияния << мог надолго занять процессор и съесть память даже при безопасной загрузке через yaml.safe_load. Кроме того, готовые пакеты теперь собраны с libyaml 0.2.6, а в ней появился предел глубины вложенности.
PyYAML стоит в зависимостях у огромного числа проектов, от Ansible до веб-приложений, которые читают конфиги и настройки в YAML. Больше всего обновление нужно сервисам, которые разбирают YAML, пришедший снаружи: загруженные пользователями файлы, тела запросов к API, описания задач в CI. У одного изменения есть побочный эффект, о нём ниже.
Как маленький файл заставлял PyYAML работать часами
В YAML можно пометить кусок документа якорем (&base), сослаться на него в другом месте (*base) и подмешать его содержимое в словарь специальным ключом <<. Так в конфигах избавляются от повторов. Проблема была в том, как PyYAML обрабатывал такое слияние: если на один и тот же якорь ссылались несколько раз на разных уровнях, список элементов на каждом уровне удваивался.
Автор исправления в PR #937 описывает это так: число операций растёт как 2n+1 — 1, где n это число уровней, и документа меньше килобайта хватает на миллионы лишних шагов. Уязвимы и обычный SafeLoader, и быстрые загрузчики на C вроде CSafeLoader, потому что логику слияния они берут из одного и того же класса. В issue #897, где проблему описали ещё в октябре 2025 года, документ из 18 уровней превращался в словарь на 524 287 ключей и грузился 22 секунды.
Исправление запоминает, какие узлы уже подмешаны, и пропускает повторы. По замерам автора, документ с 22 уровнями вложенных слияний теперь грузится за 0,003 секунды вместо 3,8. В основную ветку правку приняли ещё в июне, но в релиз она попала только сейчас.
libyaml 0.2.6 ограничивает вложенность тысячей уровней
В ту же ночь вышла libyaml 0.2.6, библиотека на C, на которой работают быстрые загрузчики PyYAML. В ней появился настраиваемый предел глубины вложенности списков и словарей, по умолчанию около 1000 уровней. Это исправляет CVE-2026-44842: раньше каждый новый уровень вложенности добавлял парсеру памяти в стеке и работы, и очень глубокий документ можно было использовать для атаки на отказ в обслуживании.
Колёса PyYAML 6.0.4 на PyPI собраны уже с этой версией, поэтому загрузчики с буквой C в названии (CLoader, CSafeLoader, CFullLoader и другие) на документе глубже 1000 уровней выбрасывают ScannerError с текстом «exceeded maximum nesting depth». Обычный SafeLoader написан на чистом Python и этот предел не использует. Если PyYAML собран из исходников со старой libyaml, функции управления пределом ничего не делают, а текущее значение возвращается как -1.
Проверить, что стоит у вас, можно одной командой. На свежем колесе она выведет 6.0.4 True 1000:
python3 -c "import yaml; print(yaml.__version__, yaml.__with_libyaml__, yaml._yaml._get_max_nest_level())"
Поменять предел можно через yaml._yaml._set_max_nest_level(), но мейнтейнеры прямо советуют без нужды этого не делать: значение общее на весь процесс, а смена небезопасна при работе в нескольких потоках.
При слиянии ключей теперь побеждает последний источник
Теперь о побочном эффекте. По спецификации YAML, если подмешать несколько якорей списком <<: [*a, *b] и в них есть одинаковые ключи, побеждает значение из первого источника. Исправление из PR #937 поменяло этот порядок: для ключей из двух и более символов теперь побеждает последний источник. Об этом с августа открыт issue #953, а PR #954 с исправлением пока не принят, так что в 6.0.4 новое поведение уже есть.
base_a: &a kk: 1 base_b: &b kk: 2 result: <<: [*a, *b] # PyYAML 6.0.3: result.kk = 1 # PyYAML 6.0.4: result.kk = 2
С однобуквенными ключами всё по-старому, но только потому, что CPython хранит такие строки в единственном экземпляре. Если в ваших конфигах есть списки якорей в << с пересекающимися ключами и вы полагаетесь на порядок, после обновления проверьте итоговые значения. Найти такие места можно поиском по <<: [.
Как обновиться
- pip:
pip install -U "PyYAML==6.0.4", в requirements.txt поднять версию до 6.0.4. - uv:
uv lock --upgrade-package pyyaml, затемuv sync. - Python 3.8 и 3.9 больше не поддерживаются, на них pip останется на 6.0.3 без исправления. Заодно появилась поддержка Python 3.15.
- Пакет
python3-yamlиз репозитория дистрибутива обновляется отдельно, по графику его мейнтейнеров.
Если ваш сервис разбирает чужой YAML, обновление до PyYAML 6.0.4 стоит поставить в ближайшее время: оно закрывает способ положить сервер маленьким файлом и ограничивает глубину вложенности. Если YAML только ваш собственный, спешки меньше, но перед обновлением проверьте конфиги, где несколько якорей подмешиваются одним списком.