SpringBoot整合SQLite时创建entityManagerFactory Bean报错求助

使用Java、Maven、SpringBoot 3.1.3和SQLite开发Web应用时，项目启动失败，报错创建entityManagerFactory Bean失败，核心错误为java.lang.NoSuchFieldError: BEFORE_TRANSACTION_COMPLETION。

报错堆栈 #

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: BEFORE_TRANSACTION_COMPLETION
        at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1770) ~[spring-beans-6.0.11.jar:6.0.11]
        ...（省略部分栈信息）
Caused by: java.lang.NoSuchFieldError: BEFORE_TRANSACTION_COMPLETION
        at org.hibernate.resource.jdbc.spi.PhysicalConnectionHandlingMode.<clinit>(PhysicalConnectionHandlingMode.java:50) ~[hibernate-core-6.2.7.Final.jar:6.2.7.Final]
        ...（省略部分栈信息）

问题原因 #

该错误由依赖版本不兼容导致：

• SpringBoot 3.1.3默认依赖Hibernate 6.2.x，而原配置中使用的net.kemitix:sqlite-dialect:0.1.0是基于旧版Hibernate（5.x）开发的，无法适配Hibernate 6.x的API变更，BEFORE_TRANSACTION_COMPLETION字段在Hibernate 6.x中已被移除或重命名，引发反射调用失败。
• 原配置中的sqlite-jdbc:3.34.0版本过于老旧，与SpringBoot 3.x存在兼容性问题。
• 手动引入的javax.xml.bind:jaxb-api和org.javassist:javassist属于冗余依赖，SpringBoot 3.x已内置相关适配，手动指定旧版本会引发依赖冲突。

解决方案 #

1. 替换为适配Hibernate 6.x的SQLite方言，使用org.xerial:sqlite-jdbc自带的方言实现。
2. 更新sqlite-jdbc至最新稳定版，保证与SpringBoot 3.x的兼容性。
3. 移除冗余的jaxb-api和javassist依赖，避免版本冲突。

修改后的pom.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.mywebapp</groupId>
    <artifactId>server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>server</name>
    <description>Server for my Web App</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <!-- 更新sqlite-jdbc到最新稳定版 -->
        <dependency>
            <groupId>org.xerial</groupId>
            <artifactId>sqlite-jdbc</artifactId>
            <version>3.45.2.0</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

修改后的application.properties配置 #

spring.datasource.url=jdbc:sqlite:src/main/resources/database/database.db
spring.datasource.driver-class-name=org.sqlite.JDBC
# 使用sqlite-jdbc自带的适配Hibernate 6的方言
spring.jpa.database-platform=org.sqlite.hibernate6.SQLiteDialect
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=none

验证步骤 #

1. 执行mvn clean install清理并重新构建项目
2. 启动SpringBoot应用，检查是否正常启动
3. 若数据库文件不存在，需先创建空的database.db文件放在src/main/resources/database/目录下

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