Corriger les dépendances cassées sous Linux (APT et DNF)

sudo apt --fix-broken install répare la plupart des dépendances cassées sur Debian/Ubuntu, sudo dnf distro-sync réaligne les paquets sur RHEL/Fedora. Ces deux commandes sont le premier réflexe quand le gestionnaire de paquets refuse d’installer ou de mettre à jour quoi que ce soit.

Ce que vous allez apprendre

• Diagnostiquer le type de problème : installation interrompue, conflit ou paquet manquant
• Réparer une installation APT/dpkg interrompue
• Résoudre un conflit de dépendances avec APT et DNF
• Débloquer un gestionnaire de paquets verrouillé
• Connaître les commandes de dernier recours sans casser le système
• Prévenir les problèmes de dépendances

Dans quel contexte ?

Les dépendances cassées sont un problème classique en administration Linux :

• Une mise à jour a été interrompue (coupure réseau, Ctrl+C malencontreux, reboot pendant un apt upgrade) — dpkg est dans un état incohérent
• Vous ajoutez un PPA ou un dépôt tiers qui fournit une version incompatible d’une bibliothèque partagée
• Un paquet a été supprimé manuellement avec dpkg --remove --force et d’autres paquets dépendent de lui
• Après une montée de version distribution, certains paquets ne sont plus disponibles dans les nouveaux dépôts
• apt install ou dnf install échoue avec un message de dépendances non satisfaites et vous ne savez pas par où commencer

LFCS / RHCSA

La gestion des paquets et la résolution de problèmes logiciels font partie du domaine Gestion logicielle de la RHCSA (dnf, modules AppStream) et du domaine Commandes essentielles de la LFCS. Savoir débloquer un gestionnaire de paquets cassé est une compétence attendue.

Diagnostiquer le problème

Avant de réparer, identifiez le type de problème :

Debian / Ubuntu

Vérifier l’état de dpkg

sudo dpkg --audit

Si des paquets apparaissent, ils sont dans un état incohérent (installation partielle, configuration incomplète).

Vérifier les dépendances APT

sudo apt-get check

Reading package lists...
Building dependency tree...
Reading state information...

Si tout est propre, aucun message d’erreur n’apparaît. Sinon, APT indique les paquets avec des dépendances insatisfaites.

Lister les paquets cassés

dpkg -l | grep -E '^(iU|iF|iH|.I)'

État	Signification
ii	Installé correctement
iU	Déballé mais pas configuré
iF	Configuration échouée
iHR	Installation interrompue, nécessite réinstallation
rc	Supprimé, fichiers de config restants

Glissez pour voir

RHEL / Fedora

Vérifier la cohérence RPM

sudo dnf check

Signale les dépendances manquantes, les doublons et les conflits dans la base RPM.

Lister les problèmes

sudo dnf repoquery --unsatisfied

Liste les paquets installés dont les dépendances ne sont plus satisfaites.

Vérifier l’historique des transactions

sudo dnf history list

Les transactions marquées comme incomplètes sont à vérifier :

sudo dnf history info <id>

Réparer — Debian / Ubuntu

1. Terminer les configurations dpkg en attente

   sudo dpkg --configure -a

   Cette commande termine la configuration de tous les paquets partiellement installés. C’est toujours la première chose à essayer.

2. Réparer les dépendances cassées avec APT

   sudo apt --fix-broken install

   APT télécharge et installe les dépendances manquantes, ou supprime les paquets incohérents. Vérifiez ce qu’il propose avant de confirmer.

3. Mettre à jour la liste des paquets

   sudo apt update

   Si un dépôt a été modifié ou supprimé, les métadonnées locales sont peut-être obsolètes.

4. Réessayer l’installation

   sudo apt install -f

   L’option -f (fix) force APT à résoudre les dépendances avant de continuer.

5. Vérifier le résultat

   sudo dpkg --audit
   sudo apt-get check

   Les deux commandes doivent être silencieuses (aucune sortie = système propre).

Cas spécial : dpkg verrouillé

Si apt ou dpkg affiche :

E: Could not get lock /var/lib/dpkg/lock-frontend

Un autre processus dpkg est en cours. Vérifiez d’abord :

ps aux | grep -E 'apt|dpkg'

Si un processus apt ou dpkg tourne encore, attendez qu’il finisse. Si la machine a redémarré pendant une mise à jour et qu’aucun processus ne tourne :

sudo rm /var/lib/dpkg/lock-frontend
sudo rm /var/lib/dpkg/lock
sudo dpkg --configure -a

Ne supprimez les verrous que si aucun processus dpkg ne tourne

Supprimer un fichier lock pendant qu’un apt est actif peut corrompre la base de données dpkg. Vérifiez toujours avec ps aux | grep dpkg avant.

Cas spécial : paquet impossible à supprimer

Si un paquet est dans un état tellement cassé qu’il ne peut ni être reconfiguré ni supprimé :

sudo dpkg --remove --force-remove-reinstreq nom-du-paquet
sudo apt --fix-broken install

Forcer la réinstallation d’un paquet

sudo apt install --reinstall nom-du-paquet

Retélécharge et réinstalle le paquet sans le supprimer d’abord.

Réparer — RHEL / Fedora

1. Synchroniser les paquets avec les dépôts

   sudo dnf distro-sync

   Aligne tous les paquets installés sur les versions disponibles dans les dépôts actifs. Résout la plupart des problèmes post-mise à jour.

2. Réinstaller un paquet suspect

   sudo dnf reinstall nom-du-paquet

3. Vérifier et réparer la base RPM

   sudo rpm --rebuilddb

   Reconstruit la base de données RPM si dnf signale des erreurs d’accès à la base.

4. Nettoyer le cache

   sudo dnf clean all
   sudo dnf makecache

   Force le retéléchargement des métadonnées de tous les dépôts.

5. Vérifier le résultat

   sudo dnf check

Annuler une transaction DNF

sudo dnf history list

ID | Command line             | Date and time    | Action(s) | Altered
 8 | install nginx            | 2026-04-15 14:30 | Install   | 3
 7 | update                   | 2026-04-14 09:00 | Upgrade   | 42

Pour annuler la transaction n°8 :

sudo dnf history undo 8

DNF défait les changements effectués par cette transaction (supprime les paquets installés, restaure les versions précédentes).

Résoudre un conflit de version

Si un dépôt tiers fournit une version incompatible :

# Identifier le dépôt source
dnf repoquery --info nom-du-paquet

# Exclure un dépôt temporairement
sudo dnf update --disablerepo=nom-du-depot-tiers

# Verrouiller un paquet à sa version actuelle
sudo dnf versionlock add nom-du-paquet

Problèmes liés aux dépôts tiers

Identifier les dépôts problématiques

# Debian/Ubuntu
grep -r "^deb " /etc/apt/sources.list /etc/apt/sources.list.d/

# RHEL/Fedora
dnf repolist

Désactiver temporairement un dépôt

Debian / Ubuntu

# Renommer le fichier pour le désactiver
sudo mv /etc/apt/sources.list.d/depot-tiers.list /etc/apt/sources.list.d/depot-tiers.list.disabled
sudo apt update
sudo apt --fix-broken install

RHEL / Fedora

sudo dnf --disablerepo=depot-tiers update
# Ou désactivation permanante
sudo dnf config-manager --set-disabled depot-tiers

Vérifier les paquets provenant de dépôts tiers (APT)

apt list --installed 2>/dev/null | grep -v "ubuntu\|debian"

Bloquer un paquet pour éviter les mises à jour

Debian / Ubuntu

# Bloquer
sudo apt-mark hold nom-du-paquet

# Vérifier
apt-mark showhold

# Débloquer
sudo apt-mark unhold nom-du-paquet

RHEL / Fedora

# Installer le plugin versionlock
sudo dnf install dnf-plugin-versionlock

# Bloquer
sudo dnf versionlock add nom-du-paquet

# Lister
dnf versionlock list

# Débloquer
sudo dnf versionlock delete nom-du-paquet

Prévenir les problèmes

• Ne jamais interrompre apt upgrade ou dnf update — si un Ctrl+C est nécessaire, exécutez dpkg --configure -a ou dnf distro-sync immédiatement après
• Éviter les dépôts tiers non fiables — chaque PPA ou dépôt externe est un risque de conflit
• Tester les mises à jour majeures sur un serveur de test avant la production (apt upgrade --dry-run, dnf update --assumeno)
• Garder les métadonnées à jour : apt update avant chaque installation
• Documenter les paquets bloqués (apt-mark showhold, dnf versionlock list) — un paquet gelé oublié deviendra un problème plus tard

Dépannage

Symptôme	Cause probable	Solution
Could not get lock /var/lib/dpkg/lock	Autre processus dpkg actif	Vérifier ps aux | grep dpkg, attendre ou supprimer le lock si aucun processus
Unmet dependencies après install	Dépôt tiers incompatible	Désactiver le dépôt, apt --fix-broken install
dpkg --configure -a boucle en erreur	Script postinst du paquet cassé	dpkg --remove --force-remove-reinstreq paquet
dnf check signale des doublons	Mise à jour partielle	dnf remove --duplicates puis dnf distro-sync
Package X has no installation candidate	Dépôt supprimé ou paquet retiré	apt update, vérifier les sources
Error: Transaction check error (DNF)	Conflit entre packages	dnf --best --allowerasing install paquet
Base RPM corrompue	Crash pendant transaction	rpm --rebuilddb puis dnf clean all

Glissez pour voir

# Diagnostic rapide — Debian/Ubuntu
sudo dpkg --audit                    # Paquets en état incohérent
sudo apt-get check                   # Dépendances insatisfaites
apt-mark showhold                    # Paquets bloqués

# Diagnostic rapide — RHEL/Fedora
sudo dnf check                       # Cohérence des dépendances
sudo dnf history list                # Dernières transactions
dnf versionlock list                 # Paquets verrouillés

À retenir

• dpkg --configure -a est toujours la première commande après une installation interrompue sur Debian/Ubuntu
• apt --fix-broken install résout la majorité des problèmes de dépendances APT
• dnf distro-sync réaligne tous les paquets sur RHEL/Fedora — c’est l’équivalent du « fix broken » côté DNF
• Ne supprimez jamais les fichiers lock si un processus dpkg/apt est encore actif
• dnf history undo permet d’annuler une transaction problématique — APT n’a pas d’équivalent aussi simple
• Les dépôts tiers sont la première cause de conflits de dépendances — désactivez-les pour isoler le problème
• apt-mark hold et dnf versionlock bloquent un paquet pour éviter des mises à jour incompatibles
• En dernier recours, dpkg --remove --force-remove-reinstreq permet de supprimer un paquet irrécupérable

Prochaines étapes

Gestion des paquets sous Linux Vue d'ensemble des gestionnaires APT, DNF, Pacman, Zypper, APK

APT — Debian et Ubuntu Guide complet du gestionnaire de paquets Debian

DNF — RHEL et Fedora Guide complet du gestionnaire de paquets Red Hat

Appliquer les mises à jour de sécurité Mises à jour ciblées sécurité, unattended-upgrades, dnf-automatic

×

📖 Voir la documentation →