Linux dpkg-configure-failedВысокая

Как исправить ошибку dpkg: configuration script failed

При установке или обновлении пакетов через apt может появиться ошибка «dpkg: configuration script failed». Эта статья расскажет, почему скрипт конфигурации не работает и как быстро исправить проблему.

Обновлено 12 августа 2026 г.
5-10 мин
Средняя
FixPedia Team
Применимо к:Ubuntu 20.04 LTSUbuntu 22.04 LTSUbuntu 24.04 LTSDebian 10 (buster)Debian 11 (bullseye)

Что означает ошибка dpkg-configure-failed

Ошибка dpkg: configuring package …: configuration script failed появляется, когда менеджер пакетов (dpkg) пытается запустить скрипт post‑install пакета, но тот завершается с ненулевым кодом возврата. В результате пакет остаётся в состоянии полуустановленного, а запланированные операции (обновления, конфигурация) блокируются.

Причины возникновения

  1. Сбой в скрипте установки – скрипт postinst содержит ошибки (синтаксис, отсутствующие зависимости или неверные разрешения).
  2. Недостаточные права – скрипт не может записать изменения без прав администратора.
  3. Поврежденные файлы пакета – файлы .deb или записи в /var/lib/dpkg/status повреждены.
  4. Конфликт зависимостей – несколько пакетов требуют разные версии других библиотек.
  5. Нехватка места на диске – процессор завершается с ошибкой, потому что не хватает свободного места для временных файлов.

Способы решения

Способ 1: Принудительная конфигурация dpkg

  1. Проверить права пользователя
    Убедитесь, что у вас есть права sudo или вы работаете под root. Без этих прав скрипт не сможет записать изменения.
  2. Запустить принудительную конфигурацию dpkg
    sudo dpkg --configure -a
    

    Эта команда заставляет dpkg повторно обработать все зависшие пакеты, пытаясься запустить их скрипты конфигурации с начала.
  3. Удалить поврежденный пакет
    Найдите проблемный пакет:
    dpkg -l | grep "half-installed"
    

    Удалите его:
    sudo dpkg --purge <package>
    

    Переустановите пакет из репозитория:
    sudo apt update && sudo apt install <package>
    

Способ 2: Ручное исправление скрипта postinst

  1. Найти скрипт postinst
    grep -R "postinst" /usr/share/doc/<package>/
    

    Замените <package> на имя пакета, который вызывает ошибку (например, git).
  2. Проверить скрипт на наличие очевидных проблем
    • Убедитесь, что в скрипте указаны правильные пути.
    • Проверьте синтаксис bash (bash -n /path/to/postinst).
    • Убедитесь, что все необходимые библиотеки или инструменты установлены.
  3. Исправить или переустановить
    • Если вы можете безопасно исправить скрипт, сохраните изменения.
    • В противном случае удалите пакет (sudo dpkg --purge <package>) и переустановите его:
      sudo apt update
      sudo apt install <package>
      

Способ 3: Использовать apt для исправления зависимостей

  1. Запустить apt в режиме автоматического исправления
    sudo apt -f install
    

    Эта команда удалит частично установленные пакеты, которые вызывают конфликт, и переустановит их в правильном порядке.
  2. Обновить кэш пакетов
    sudo apt update
    
  3. Повторно установить проблемный пакет
    sudo apt install <package>
    

Профилактика

  • Регулярно запускать sudo dpkg --configure -a после любых сетевых сбоев.
  • Сохранять чистоту кэша apt – время от времени очищайте /var/cache/apt/archives.
  • Проверять свободное место на диске перед большими установками (df -h).
  • Избегать ручных редакций .deb – используйте официальные репозитории.
  • Использовать sudo apt --fix-broken install сразу при появлении предупреждения о «полуустановленном» пакете.

⚠️ Важно: Если ошибка повторяется после всех попыток, создайте отладочный журнал (sudo dpkg --configure -a 2>&1 | tee /tmp/dpkg-error.log) и найдите конкретную строку ошибки в скрипте – это укажет на точную причину сбоя.

Часто задаваемые вопросы

Почему появляется сообщение «dpkg: configuring package ...: configuration script failed»?
Как быстро исправить эту ошибку?
Что делать, если ошибка появляется после каждой переустановки?

Полезное

Проверить права пользователя
Запустить принудительную конфигурацию dpkg
Удалить поврежденный пакет
Проверить и исправить скрипт postinst

Эта статья помогла вам решить проблему?