Lỗi Gặp Phải
Bạn chạy apt install nginx hoặc apt upgrade và terminal hiện ra:
dpkg: error processing package nginx (--configure)
dpkg: dependency problems prevent configuration of nginx
Errors were encountered while processing:
nginx
Lúc này apt bị hỏng một nửa. Mọi lệnh apt install hoặc apt upgrade tiếp theo đều báo lỗi tương tự. Chào mừng bạn đến với địa ngục dpkg.
Nguyên Nhân Thực Sự
dpkg — trình quản lý gói cấp thấp bên dưới apt — đã cố cấu hình một gói sau khi giải nén, nhưng bị chặn lại. Thường là do một trong những nguyên nhân sau:
- Một dependency bị thiếu, sai phiên bản, hoặc chính nó cũng bị lỗi
- Quá trình cài đặt hoặc nâng cấp trước đó bị gián đoạn giữa chừng (mất điện, Ctrl+C, mất kết nối SSH)
- Script sau cài đặt (
postinst) bị crash hoặc thoát với mã lỗi khác 0 - Các gói xung đột đang chặn quá trình cấu hình
- Chính cơ sở dữ liệu gói đang ở trạng thái không nhất quán
Một gói bị kẹt sẽ đóng băng toàn bộ hệ thống apt. Không thể cài đặt hay nâng cấp gì cho đến khi bạn sửa trạng thái lỗi đó.
Cách Sửa — Thực Hiện Theo Thứ Tự
Bước 1: Ép buộc cấu hình các gói đang chờ
Bắt đầu từ đây. Lệnh này yêu cầu dpkg hoàn thành việc cấu hình những gì còn đang dang dở:
sudo dpkg --configure -a
Không có lỗi? Tốt. Chạy tiếp ngay sau đó:
sudo apt install -f
Cờ -f có nghĩa là "fix broken" — apt quét các dependency chưa được đáp ứng và tự động giải quyết. Chạy apt upgrade sau để xác nhận hệ thống đã sạch.
Bước 2: Sửa các dependency bị lỗi
Vẫn còn lỗi? Để apt tự khắc phục:
sudo apt --fix-broken install
sudo apt autoremove
sudo apt autoclean
Sau đó thử lại lệnh cài đặt ban đầu:
sudo apt install nginx
Bước 3: Xóa và cài lại gói bị lỗi
Đôi khi cách duy nhất là gỡ bỏ gói bị lỗi và bắt đầu lại từ đầu:
# Xóa hoàn toàn gói (bao gồm cả file cấu hình)
sudo dpkg --purge nginx
# Hoặc chỉ xóa mà không đụng đến cấu hình
sudo dpkg --remove nginx
# Dọn dẹp các lỗi còn sót lại
sudo apt install -f
# Cài lại
sudo apt install nginx
Nếu bản thân dpkg --purge bị lỗi script, hãy ép buộc nó:
sudo dpkg --purge --force-remove-reinstreq nginx
Bước 4: Xử lý xung đột dependency thủ công
Khi thông báo lỗi chỉ rõ tên một dependency cụ thể, hãy xử lý trực tiếp:
# Lọc toàn bộ output lỗi để tìm chuỗi dependency
sudo apt install nginx 2>&1 | grep "Depends"
# Cài đặt dependency còn thiếu một cách tường minh
sudo apt install libssl1.1
# Sau đó thử lại
sudo apt install nginx
Xung đột phiên bản phức tạp hơn. Kiểm tra các phiên bản thực sự có sẵn, rồi ghim một phiên bản đang hoạt động:
# Xem tất cả các phiên bản có sẵn
apt-cache policy nginx
# Cài đặt một phiên bản cụ thể
sudo apt install nginx=1.18.0-0ubuntu1.4
Bước 5: Xóa cache gói và làm mới
Các file .deb cũ hoặc tải xuống dở dang gây ra lỗi âm thầm rất dễ bỏ sót. Hãy xóa sạch chúng:
sudo apt clean
sudo apt update
sudo apt install nginx
Bước 6: Phương án cuối — xây dựng lại cơ sở dữ liệu dpkg
Biện pháp cuối cùng. Cơ sở dữ liệu trạng thái dpkg có thể bị hỏng sau lỗi đĩa hoặc khởi động lại cứng giữa chừng khi đang nâng cấp. Sao lưu trước, rồi xóa các file lock bị kẹt:
# Sao lưu cơ sở dữ liệu trạng thái
sudo cp /var/lib/dpkg/status /var/lib/dpkg/status.bak
# Xóa các file lock còn sót từ lần chạy trước bị kẹt
sudo rm -f /var/lib/dpkg/lock-frontend
sudo rm -f /var/lib/dpkg/lock
sudo rm -f /var/cache/apt/archives/lock
sudo rm -f /var/lib/apt/lists/lock
# Cấu hình lại toàn bộ
sudo dpkg --configure -a
sudo apt install -f
sudo apt update && sudo apt upgrade
Lưu ý quan trọng: Chỉ xóa file lock khi bạn chắc chắn không có tiến trình apt hoặc dpkg nào đang chạy. Kiểm tra trước: ps aux | grep -E 'apt|dpkg'
Xác Nhận Đã Sửa Xong
Trước khi kết luận xong việc, hãy kiểm tra nhanh:
# Tìm các gói còn ở trạng thái lỗi
sudo dpkg --audit
# Liệt kê các gói có cờ trạng thái xấu (rc, iF, iU, rF)
dpkg -l | grep -E '^(rc|iF|iU|rF)'
# Nếu cả hai lệnh không trả về gì, hệ thống đã sạch
# Xác nhận bằng cách nâng cấp toàn bộ
sudo apt update && sudo apt upgrade
Một hệ thống khỏe mạnh sẽ không trả về kết quả nào từ dpkg --audit. Đó là tín hiệu xanh cho bạn.
Trường Hợp Cụ Thể: Script postinst Bị Lỗi
Thấy postinst xuất hiện trong thông báo lỗi? Gói đã được giải nén thành công — nó thất bại trong quá trình cài đặt. Nguyên nhân thường gặp: một dịch vụ không khởi động được vì cổng 80 đã bị chiếm, hoặc file cấu hình có lỗi cú pháp.
# Kiểm tra xem có gì đang dùng cổng 80 (với nginx)
sudo ss -tlnp | grep :80
# Kiểm tra trạng thái dịch vụ để tìm manh mối
sudo systemctl status nginx
# Đọc script postinst để hiểu nó đang cố làm gì
cat /var/lib/dpkg/info/nginx.postinst
Tắt dịch vụ đang xung đột hoặc sửa lại cấu hình, rồi hoàn tất cấu hình thủ công: sudo dpkg --configure nginx.
Phòng Ngừa
- Không bao giờ nhấn Ctrl+C trong khi apt đang chạy — nếu thực sự phải dừng, hãy chờ gói hiện tại cài xong trước
- Cẩn thận khi dùng PPA — PPA từ bên thứ ba là nguồn gây xung đột dependency lớn nhất trên Ubuntu; mỗi PPA thêm vào là một rủi ro tiềm ẩn
- Cập nhật thường xuyên — chạy
sudo apt update && sudo apt upgradehàng tuần giúp giữ khoảng cách dependency ở mức nhỏ; bỏ qua sáu tháng cập nhật rồi nâng cấp một lần là công thức sinh ra xung đột - Dùng
apt, không dùngdpkg, để cài đặt — apt tự động giải quyết dependency; dpkg chỉ đơn giản là giải nén gói một cách mù quáng - Theo dõi dung lượng đĩa — phân vùng
/varđầy khiến dpkg thất bại giữa chừng khi ghi dữ liệu, để lại các gói cài đặt dở dang; kiểm tra trước mọi lần nâng cấp lớn:df -h /var
Nếu bạn quản lý server bằng Ansible hoặc cloud-init, cấu hình YAML sai cũng là một cách khiến quá trình cài đặt thất bại trước khi dpkg kịp vào cuộc. YAML ↔ JSON Converter của ToolCraft cho phép bạn kiểm tra cú pháp YAML ngay trên trình duyệt mà không cần tải file lên — rất tiện để phát hiện lỗi đánh máy trước khi đẩy lên server.