Hibernate 및 PostgreSQL을 사용하여 Docker Compose에서 JDBC 연결 문제 해결

Dockerized Spring Boot 애플리케이션에서 JDBC 연결 오류 디버깅

서비스 오케스트레이션에는 Docker Compose를 사용하고 백엔드에는 Java를 사용합니다.

# Solution 1: Correcting the Hostname Configuration
# Problem: The Spring Boot application cannot resolve the hostname for the PostgreSQL container.
version: '3.7'
services:
  app:
    build: .
    ports:
      - "8090:8080"
    depends_on:
      - postgres
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/student
    networks:
      - mynetwork
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_USER: reddy
      POSTGRES_PASSWORD: 1234
      POSTGRES_DB: student
    ports:
      - "5432:5432"
    networks:
      - mynetwork
networks:
  mynetwork:
    driver: bridge

올바른 연결을 위해 Java 애플리케이션 속성 리팩터링

데이터베이스 연결을 위한 Spring Boot 구성 수정

# Solution 2: Update the application.properties file
# Problem: Incorrect database connection properties in the Spring Boot configuration.
spring.datasource.driver-class-name=org.postgresql.Driver
spring.datasource.url=jdbc:postgresql://postgres:5432/student
spring.datasource.username=reddy
spring.datasource.password=1234
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
server.port=8090

사용자 정의 초기화 스크립트를 사용하여 연결 테스트

오류 진단 및 데이터베이스 설정을 위한 데이터베이스 초기화 스크립트를 추가합니다.

# Solution 3: Using a custom SQL initialization script
# Problem: Ensuring database schema initialization during container startup.
services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_USER: reddy
      POSTGRES_PASSWORD: 1234
      POSTGRES_DB: student
    volumes:
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
    ports:
      - "5432:5432"
    networks:
      - mynetwork
networks:
  mynetwork:
    driver: bridge

Spring Boot에서 JDBC 연결 단위 테스트

견고성을 위해 JUnit 및 Spring Boot를 사용하여 데이터베이스 연결을 테스트합니다.

# Solution 4: Write a JUnit test for database connectivity
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.SQLException;
@SpringBootTest
public class DatabaseConnectionTest {
    @Autowired
    private DataSource dataSource;
    @Test
    public void testDatabaseConnection() throws SQLException {
        try (Connection connection = dataSource.getConnection()) {
            assert connection != null : "Database connection failed!";
        }
    }
}

JDBC 및 Docker Compose 통합에 대한 일반적인 질문

1. 원인은 무엇입니까? UnknownHostException 오류?
2. 이 오류는 애플리케이션이 데이터베이스 호스트 이름을 확인할 수 없을 때 발생합니다. 서비스 이름을 확인하세요. Docker Compose 애플리케이션 구성의 호스트 이름과 일치합니다.
3. PostgreSQL이 컨테이너에 준비되어 있는지 어떻게 확인할 수 있나요?
4. 애플리케이션 컨테이너를 시작하기 전에 대기 스크립트 또는 유사한 유틸리티를 사용하여 PostgreSQL 컨테이너의 준비 상태를 확인하십시오.
5. 왜? depends_on 명령이 충분하지 않습니까?
6. 그만큼 depends_on 명령은 시작 순서만 보장하지만 종속 컨테이너가 완전히 작동할 때까지 기다리지 않습니다.
7. 무엇을 하는가? docker-entrypoint-initdb.d 디렉토리는 해?
8. 이 디렉터리의 파일은 PostgreSQL 컨테이너 시작 중에 자동으로 실행되므로 데이터베이스 초기화 스크립트에 이상적입니다.
9. 데이터베이스 URL을 어떻게 구성합니까? application.properties?
10. URL이 다음 형식을 따르는지 확인하세요. jdbc:postgresql://hostname:port/databasename, 자리 표시자를 실제 값으로 바꿉니다.

연결 문제 해결을 위한 주요 사항

Docker화된 환경에서 Spring Boot 애플리케이션과 PostgreSQL 데이터베이스 간의 적절한 통신을 보장하는 것이 중요합니다. 호스트 이름 불일치, 타이밍 문제, JDBC 구성 오류를 해결하면 오류를 크게 줄일 수 있습니다. 이러한 솔루션 없이 프로덕션에 앱을 배포한다고 상상해보세요. 연결 문제로 인해 심각한 지연이 발생할 수 있습니다. ⏳

개발자는 준비 상태 확인, 네트워크 구성 및 강력한 오류 처리를 구현하여 연결 관련 문제를 예방할 수 있습니다. 이러한 방식은 개발 경험을 향상시킬 뿐만 아니라 안정적인 배포도 보장합니다. 이러한 도구를 사용하면 디버깅이 덜 번거로워지고 원활한 애플리케이션 실행이 가능해집니다. 🚀