Docker部署Spring Boot微服务时HikariDataSource实例化失败求助

1. 检查Gradle依赖打包是否包含JDBC驱动 #

确保JDBC驱动依赖被正确打包到可执行Jar中：

• 如果用runtimeOnly声明驱动（如MySQL驱动），确认Spring Boot的bootJar插件已启用（默认启用），它会将runtime依赖纳入最终Jar。示例依赖配置：

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    runtimeOnly 'com.mysql:mysql-connector-j' // 需确保该依赖被打包
}

• 执行./gradlew bootJar后，解压build/libs/下生成的Jar包，检查BOOT-INF/lib目录是否存在驱动Jar（如mysql-connector-j-xxx.jar）。若缺失，可临时将依赖范围改为implementation验证。

2. 修正Docker环境下的数据库连接配置 #

本地localhost指向宿主机，但Docker容器内的localhost是容器自身，导致数据库连接失败进而触发驱动检测异常：

• 修改application.properties中的数据库URL，将localhost替换为宿主机IP（如192.168.xxx.xxx），若用Docker Compose编排则替换为数据库服务名（如mysql）：

# 本地可用但Docker容器内不可用的配置
spring.datasource.url=jdbc:mysql://localhost:3306/db_name?useSSL=false&serverTimezone=UTC

# Docker环境修正后（宿主机IP）
spring.datasource.url=jdbc:mysql://192.168.1.100:3306/db_name?useSSL=false&serverTimezone=UTC

# Docker Compose环境修正后（数据库服务名）
spring.datasource.url=jdbc:mysql://mysql:3306/db_name?useSSL=false&serverTimezone=UTC

• 可选：手动指定驱动类名，避免自动检测失效：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

3. 检查Dockerfile构建逻辑 #

确保Dockerfile正确复制可执行Jar并使用匹配的JDK基础镜像：

• 标准Dockerfile示例：

# 使用与本地开发匹配的JDK镜像
FROM openjdk:17-jdk-slim
WORKDIR /app
# 复制bootJar生成的可执行Jar
COPY build/libs/your-service-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

• 必须使用bootJar生成的可执行Jar，不要用jar任务生成的普通Jar（不含依赖）。

4. 验证Docker容器内的网络连通性 #

进入容器测试能否连通数据库服务器：

# 进入容器（替换container_id为你的容器ID）
docker exec -it container_id /bin/bash
# 测试网络连通性（替换数据库IP和端口）
ping 192.168.1.100
telnet 192.168.1.100 3306

若无法连通，检查Docker网络配置（如是否使用host网络模式，或Docker Compose的网络是否互通）。

内容的提问来源于stack exchange，提问作者developer