Hibernate と PostgreSQL を使用した Docker Compose での JDBC 接続の問題の修正

Docker化された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. wait-for-it スクリプトまたは同様のユーティリティを使用して、アプリケーション コンテナを開始する前に 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 の設定ミスに対処すると、エラーを大幅に減らすことができます。これらのソリューションを使用せずにアプリケーションを実稼働環境にデプロイすると、接続の問題により重大な遅延が発生する可能性があります。 ⏳

準備状況チェック、ネットワーク構成、および堅牢なエラー処理を実装することで、開発者は接続関連の問題を防ぐことができます。これらのプラクティスは、開発エクスペリエンスを向上させるだけでなく、信頼性の高い展開を保証します。このようなツールを使用すると、デバッグの手間が軽減され、アプリケーションをスムーズに起動できるようになります。 🚀