使用 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. 在启动应用程序容器之前，使用等待脚本或类似实用程序检查 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 错误配置可以显着减少错误。想象一下在没有这些解决方案的情况下在生产中部署应用程序 - 连接问题可能会导致严重的延迟。 ⏳

通过实施就绪检查、网络配置和强大的错误处理，开发人员可以防止与连接相关的问题。这些实践不仅改善了开发体验，还确保了可靠的部署。有了这些工具，调试就变得不再那么麻烦，为顺利启动应用程序铺平了道路。 🚀