Ubuntu에서 패키지 종속성 문제 해결하기 (apt-get, dpkg)

Ubuntu에서 패키지 종속성 문제 해결하기

Ubuntu에서 패키지 설치 시 의존성 오류는 시스템 안정성에 영향을 줄 수 있습니다. apt-get과 dpkg 명령어를 활용해 깨진 패키지와 의존성을 신속하게 복구하는 방법을 알아봅니다.

1. 깨진 패키지 자동 복구

apt 명령의 --fix-broken 옵션을 사용해 누락된 의존성을 자동으로 설치·제거할 수 있습니다. 문제가 발생하면 아래 순서로 실행하세요.

sudo apt update
sudo apt --fix-broken install
sudo apt install -f

– update로 색인을 최신화한 뒤, --fix-broken로 틀어진 패키지를 바로잡습니다.

2. dpkg로 개별 패키지 강제 설정

dpkg는 apt가 처리하지 못할 때 유용합니다. 중단된 설치나 미설정 패키지를 수작업으로 마무리할 수 있습니다.

sudo dpkg --configure -a
sudo dpkg -i /path/to/package.deb
sudo apt install -f

– --configure -a로 미완료 설치를 설정하고, 직접 다운로드한 .deb 파일도 dpkg로 설치하세요.

3. PPA 및 저장소 문제 점검

PPA 또는 sources.list 오류로 의존성 충돌이 발생할 수 있습니다. 잘못된 저장소를 비활성화하고 다시 업데이트합니다.

# 오류 PPA 제거
sudo add-apt-repository --remove ppa:example/ppa
# sources.list.d 내부 파일 주석 처리 후
sudo apt update

– 서드파티 PPA가 문제라면 일시적으로 비활성화 후 정상 작동 여부를 확인하세요.

실무 팁

• apt 로그(/var/log/apt/term.log)를 참고해 어떤 패키지에서 오류가 발생했는지 먼저 파악하세요.
• Docker나 VM 이미지에서 동일한 오류를 재현해 본 뒤 스크립트로 복구 명령을 자동화하면 운영 환경에 바로 적용하기 쉽습니다.
• apt-mark hold 패키지명으로 중요한 패키지 업그레이드를 일시 중단해 대규모 의존성 충돌을 예방할 수 있습니다.