Ubuntu 22.04 Broken Dependencies and Held Packages Block Upgrades

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

apt upgrade fails with unmet dependencies and held package warnings, leaving host partially patched.

Environment & Reproduction

Ubuntu 22.04 with mixed repositories, pinned versions, or manually held packages from prior maintenance.

Root Cause Analysis

Version constraints conflict across enabled repos and holds, preventing dependency solver from finding consistent candidate set.

Quick Triage

Check apt-mark showhold, apt policy, and /etc/apt/preferences* to identify pins and holds causing resolver deadlock.

Step-by-Step Diagnosis

Use apt-get -o Debug::pkgProblemResolver=yes dist-upgrade to inspect dependency chain and isolate conflicting package sources.

Solution – Primary Fix

Remove unnecessary holds, correct repository priorities, run sudo apt –fix-broken install, then complete dist-upgrade cleanly.

Solution – Alternative Approaches

Pin coherent package sets intentionally, use backports selectively, or containerize conflicting software stacks.

Verification & Acceptance Criteria

apt update and apt upgrade complete without unmet dependency errors and all required services restart successfully.

Rollback Plan

Reapply prior package holds and pins if newer dependency graph breaks workload compatibility.

Prevention & Hardening

Limit third-party repos, document pinning rationale, and audit holds quarterly in fleet maintenance.

Related Errors & Cross-Refs

Often connected with interrupted dpkg state, obsolete PPAs, and unsupported package downgrades.

Related tutorial: View the step-by-step tutorial for Ubuntu 22.04 LTS.

View all Ubuntu 22.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

apt preferences manual, Ubuntu package policy docs, and dependency resolution debugging references.