Container đã chạy nhưng cơ sở dữ liệu còn khởi tạo là nguyên nhân thường gặp của lỗi kết nối lúc deploy. Trong Docker Compose, thêm healthcheck cho PostgreSQL và dùng depends_on.condition: service_healthy trong dịch vụ phụ thuộc để chờ lượt kiểm tra thành công. Tài liệu thứ tự khởi động của Docker
1. Tạo compose.yaml trong thư mục thử nghiệm
Mẫu chỉ dùng trong Docker cục bộ và không mở cổng PostgreSQL ra ngoài máy chủ. Dịch vụ probe chạy một truy vấn rồi thoát, giúp bạn tự kiểm tra việc kết nối giữa hai container.
services:
db:
image: postgres:18
environment:
POSTGRES_USER: demo
POSTGRES_PASSWORD: demo-local-only
POSTGRES_DB: workshop
healthcheck:
test: ["CMD", "pg_isready", "-U", "demo", "-d", "workshop", "-h", "127.0.0.1"]
interval: 2s
timeout: 2s
retries: 15
start_period: 10s
probe:
image: postgres:18
environment:
PGPASSWORD: demo-local-only
depends_on:
db:
condition: service_healthy
command: ["psql", "-h", "db", "-U", "demo", "-d", "workshop", "-Atc", "SELECT 1"]
2. Chạy và đọc kết quả
docker compose config --quiet
docker compose up -d
docker compose ps -a
docker compose logs probe
Khi thành công, db báo healthy, probe thoát với mã 0 và log của probe in 1. Nếu db chưa sẵn sàng, xem docker compose logs db. Nếu db đã khỏe mà truy vấn lỗi, kiểm tra lại tên cơ sở dữ liệu, tài khoản và mật khẩu.
3. Đưa vào ứng dụng
Giữ healthcheck trên db và thay probe bằng dịch vụ backend. pg_isready xác nhận máy chủ có thể nhận kết nối. Ứng dụng vẫn cần xác thực thành công, chạy migration phù hợp và xử lý mất kết nối trong khi vận hành. Với production, lưu mật khẩu bằng cơ chế quản lý bí mật của môi trường triển khai. Tài liệu pg_isready
Ảnh bìa minh họa do AI tạo cho iCoderX.



