Spring Boot集成SQLite数据库时无法找到驱动的问题求助

我来帮你梳理下Spring Boot集成SQLite时容易踩的坑，结合你提到的配置和依赖情况，一步步排查：

一、先确认依赖是否完整且兼容 #

你提到添加了对应依赖，但大概率是漏掉了SQLite的JDBC驱动，或者依赖组合有问题。完整的Maven依赖应该包含这几个核心项：

<packaging>jar</packaging>
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>你的Spring Boot版本号</version>
    <relativePath/>
</parent>

<dependencies>
    <!-- Web服务核心依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- JPA持久化支持 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- SQLite JDBC驱动 -->
    <dependency>
        <groupId>org.xerial</groupId>
        <artifactId>sqlite-jdbc</artifactId>
        <scope>runtime</scope>
    </dependency>
    <!-- 新版Spring Boot需单独引入SQLite方言 -->
    <dependency>
        <groupId>org.hibernate.orm</groupId>
        <artifactId>hibernate-community-dialects</artifactId>
    </dependency>
</dependencies>

小提示：sqlite-jdbc的runtime scope是合理的，但要注意版本兼容——Spring Boot 3.x建议用3.40+版本，Spring Boot 2.x用3.30+版本即可

二、补充关键配置项 #

SQLite是嵌入式数据库，和MySQL这类服务型数据库差异很大，你现有的配置缺少几个必填参数：

# 必须指定SQLite驱动类，Spring Boot无法自动识别
spring.datasource.driver-class-name=org.sqlite.JDBC
# 你的原有URL配置没问题，test.db会生成在项目根目录
spring.datasource.url=jdbc:sqlite:test.db
# 调整DDL模式：create-drop在SQLite下易出现锁表问题，update更稳妥
spring.jpa.hibernate.ddl-auto=update
# 强制指定SQLite方言，否则Hibernate会用默认方言导致SQL语法错误
spring.jpa.properties.hibernate.dialect=org.hibernate.community.dialect.SQLiteDialect
# 可选：开启SQL日志，方便排查执行错误
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

三、常见启动失败原因排查 #

如果还是启动报错，优先检查这几点：

• 文件权限问题：test.db会创建在程序运行的工作目录，确保当前用户有读写权限
• Spring Boot版本冲突：比如Spring Boot 3.x用了旧版sqlite-jdbc，会因为Jakarta EE规范不兼容报错
• 方言依赖缺失：如果用的是Spring Boot 3.x+，必须单独引入hibernate-community-dialects，因为SQLite方言不在核心Hibernate包中

四、快速验证集成是否成功 #

可以写个简单的测试代码验证：

// 实体类
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    // Getter、Setter、无参构造器
}

// Repository接口
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

// 启动类中添加测试逻辑
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class SqliteDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SqliteDemoApplication.class, args);
    }

    @Bean
    CommandLineRunner init(UserRepository userRepository) {
        return args -> {
            User testUser = new User();
            testUser.setName("Test User");
            userRepository.save(testUser);
            System.out.println("已保存用户：" + userRepository.findAll());
        };
    }
}

启动后如果控制台能正常打印用户信息，说明集成成功了。

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