Java Spring+H2容器化报错：无法创建HibernateJpaConfiguration Bean

以下是针对你遇到问题的具体排查和解决步骤：

1. 检查H2依赖范围（最常见原因） #

本地IntelliJ能正常运行，是因为IDE会加载test范围的依赖，但Docker容器运行的是生产打包的JAR，默认不会包含test依赖。

打开你的pom.xml，找到H2依赖项：

<!-- 错误示例：test范围会导致打包时排除H2驱动 -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>test</scope>
</dependency>

修改为runtime范围（或直接删除scope标签，默认compile范围）：

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

2. 验证打包的JAR是否包含H2驱动 #

执行以下命令检查JAR包内是否存在H2驱动类：

jar tf target/your-app-name.jar | grep org/h2/Driver.class

• 如果输出包含org/h2/Driver.class，说明驱动已被正确打包；
• 如果无输出，说明依赖未被包含，回到第一步确认依赖配置。

3. 确保Spring Boot打包插件配置正确 #

没有Spring Boot Maven插件的话，打包出的JAR是普通JAR，不会包含所有依赖。检查pom.xml的build节点：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

重新执行打包命令：

mvn clean package

4. 检查Dockerfile配置 #

确保Dockerfile正确复制了可执行JAR，且基础镜像的JDK版本与本地开发一致：

# 示例：使用与本地匹配的JDK版本，比如JDK17
FROM openjdk:17-jdk-slim
VOLUME /tmp
# 替换为你实际的JAR文件名
COPY target/recruitment-process-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

5. 验证application.properties配置 #

确认数据库配置无错误：

spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.url=jdbc:h2:mem:recruitmentdb;DB_CLOSE_DELAY=-1
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

注意：Docker容器内运行H2内存数据库无需额外配置端口，只要驱动存在即可正常启动。

6. 排查Docker-compose配置（如果使用） #

检查docker-compose.yml是否存在覆盖数据库配置的环境变量或挂载配置，比如是否意外设置了SPRING_DATASOURCE_DRIVER_CLASS_NAME为其他驱动。

最后验证 #

重新构建镜像并启动容器：

docker build -t recruitment-app .
docker run -p8080:8080 recruitment-app

如果仍有错误，执行docker logs <容器ID>查看完整错误日志，定位其他潜在问题。

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