SQLite数据库以单个文件形式存储数据，不需要安装数据库服务，非常适合桌面应用、移动端本地存储和测试环境。在Java中通过JDBC接口操作SQLite，需要先理解驱动加载和连接地址的差异。本文会逐步演示从环境准备到完整增删改查的实现过程。
准备SQLite JDBC驱动
JDBC本身是一套接口规范，连接具体数据库时必须提供对应的驱动实现。对于SQLite，社区最常用的驱动是Xerial提供的sqlite-jdbc，它内部通过JNI调用了SQLite的C库，因此不需要单独安装SQLite程序。
如果使用Maven构建项目，可以在pom.xml中添加以下依赖。依赖坐标中的版本号可以根据实际情况调整，但建议使用较新的稳定版本。添加依赖后，Maven会自动下载驱动jar包并加入类路径。
<dependency>
<groupId>org.xerial</groupId>
<artifactId>sqlite-jdbc</artifactId>
<version>3.45.2.0</version>
</dependency>
如果不使用Maven或Gradle，可以手动从官方仓库下载sqlite-jdbc的jar文件，然后在编译和运行时通过classpath参数指定。例如在命令行中运行程序时，使用java -cp ".;sqlite-jdbc-3.45.2.0.jar" MainClass。需要注意的是，不同操作系统下classpath分隔符不同，Windows使用分号，Linux和macOS使用冒号。
驱动类名是org.sqlite.JDBC。在较新的JDBC 4.0及以上规范中，只要驱动jar包在类路径中，通常不需要手动调用Class.forName来加载驱动。但为了兼容旧环境或明确代码意图，仍然可以显式加载。如果使用Spring Boot等框架，配置数据源时只需要指定driver-class-name为org.sqlite.JDBC和正确的url即可。
建立数据库连接与URL格式
SQLite的连接URL与MySQL、PostgreSQL有明显区别。标准格式为jdbc:sqlite:数据库文件路径。如果路径中不包含目录部分，则数据库文件会创建在Java进程的当前工作目录下。例如jdbc:sqlite:test.db表示连接当前目录下的test.db文件，如果文件不存在则自动创建。
连接绝对路径时，Windows下的写法需要特别注意反斜杠转义。例如C:\data\mydb.db在Java字符串中要写成C:\\data\\mydb.db，或者使用正斜杠C:/data/mydb.db，SQLite驱动同样支持。还可以使用jdbc:sqlite::memory:创建纯内存数据库，这种模式适合单元测试，连接关闭后数据丢失。
获取Connection对象的代码非常简洁。DriverManager会根据URL自动选择合适的驱动。每次操作完毕后，需要及时关闭Connection、Statement和ResultSet，否则可能导致文件锁未释放或资源泄漏。下面的示例展示了基础连接和关闭操作。
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
public class SQLiteConnectExample {
public static void main(String[] args) {
String url = "jdbc:sqlite:test.db";
// 显式加载驱动在JDBC 4.0之后通常可以省略
try {
Class.forName("org.sqlite.JDBC");
} catch (ClassNotFoundException e) {
System.out.println("未找到SQLite JDBC驱动");
e.printStackTrace();
}
try (Connection conn = DriverManager.getConnection(url)) {
if (conn != null) {
System.out.println("数据库连接成功");
System.out.println("驱动版本: " + conn.getMetaData().getDriverVersion());
}
} catch (SQLException e) {
System.out.println("连接失败: " + e.getMessage());
}
}
}
这里的try-with-resources语句会在代码块结束时自动调用close方法，减少手动关闭的麻烦。Connection、Statement和ResultSet都实现了AutoCloseable接口，推荐使用这种方式管理资源。
执行建表与增删改查操作
得到连接后，就可以通过Statement或PreparedStatement执行SQL语句。对于没有参数的简单SQL，使用Statement即可。建表操作最好在应用启动时执行一次，可以使用CREATE TABLE IF NOT EXISTS避免重复创建时报错。SQLite的数据类型比较灵活，常用的INTEGER、TEXT、REAL、BLOB都能正常支持。
下面的代码先创建一张用户信息表，包含id、name和age三个字段，其中id为自增主键。然后插入两条记录，再使用SELECT读取所有数据并打印。注意SQLite中自增列使用INTEGER PRIMARY KEY AUTOINCREMENT，并且AUTOINCREMENT只能用于整型主键。
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
public class SQLiteCRUDExample {
public static void main(String[] args) {
String url = "jdbc:sqlite:test.db";
String createSql = "CREATE TABLE IF NOT EXISTS user_info ("
+ "id INTEGER PRIMARY KEY AUTOINCREMENT,"
+ "name TEXT NOT NULL,"
+ "age INTEGER"
+ ")";
String insertSql1 = "INSERT INTO user_info(name, age) VALUES ('张三', 25)";
String insertSql2 = "INSERT INTO user_info(name, age) VALUES ('李四', 30)";
String querySql = "SELECT id, name, age FROM user_info ORDER BY id";
try (Connection conn = DriverManager.getConnection(url);
Statement stmt = conn.createStatement()) {
stmt.execute(createSql);
stmt.executeUpdate(insertSql1);
stmt.executeUpdate(insertSql2);
try (ResultSet rs = stmt.executeQuery(querySql)) {
System.out.println("id\tname\tage");
while (rs.next()) {
int id = rs.getInt("id");
String name = rs.getString("name");
int age = rs.getInt("age");
System.out.println(id + "\t" + name + "\t" + age);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
上述代码中使用了Statement执行动态拼接的SQL，仅适用于固定值或已经验证过的数据。如果SQL中的值来自用户输入，直接拼接会造成SQL注入风险。这种情况下必须使用PreparedStatement，通过占位符传递参数。PreparedStatement还可以预编译SQL语句，多次执行相同结构不同参数的插入或更新时性能更好。
SQLite支持事务，默认会自动提交每一条SQL语句。如果需要把多个操作放在同一个事务中，可以调用conn.setAutoCommit(false)关闭自动提交，在所有操作成功后调用conn.commit()，发生异常时调用conn.rollback()回滚。事务能够保证数据一致性，例如同时更新多个表或者批量插入时避免部分成功。
使用预编译语句与事务控制
PreparedStatement的使用方法与其他数据库完全一致。用问号作为占位符，再通过setString、setInt等方法绑定参数。参数索引从1开始，而不是从0开始。绑定后执行executeUpdate或executeQuery，驱动会负责转义特殊字符，从根本上防止SQL注入。
下面示例演示了插入一行数据并使用事务包裹批量操作。首先关闭自动提交，执行两条带参数的更新，模拟转账或库存扣减场景。如果中间任意一步抛出异常，事务回滚，之前执行的操作不会写入数据库。成功时提交事务，保证所有修改一起生效。
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
public class SQLiteTransactionExample {
public static void main(String[] args) {
String url = "jdbc:sqlite:test.db";
String updateSql = "UPDATE user_info SET age = ? WHERE name = ?";
try (Connection conn = DriverManager.getConnection(url)) {
conn.setAutoCommit(false);
try (PreparedStatement pstmt = conn.prepareStatement(updateSql)) {
pstmt.setInt(1, 26);
pstmt.setString(2, "张三");
pstmt.executeUpdate();
pstmt.setInt(1, 31);
pstmt.setString(2, "李四");
pstmt.executeUpdate();
conn.commit();
System.out.println("事务提交成功");
} catch (Exception e) {
conn.rollback();
System.out.println("事务回滚: " + e.getMessage());
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
需要注意，SQLite在并发写入方面的支持较弱，同一时间只允许一个写连接。如果多个线程同时写入，可能会抛出SQLITE_BUSY异常。解决方案包括使用连接池控制写入串行化、设置busy_timeout等待锁释放、或者将数据库文件放在本地高速磁盘上。对于读操作，可以多个连接并发读取，但写操作会锁定整个数据库文件。
在实际项目中，建议将数据库操作封装到独立的DAO类中，通过统一的工具方法获取连接，避免在每个方法里重复编写URL和异常处理。连接池可以使用HikariCP等，但SQLite作为内嵌数据库时，通常保持单个连接即可，过多连接反而增加文件锁竞争。
常见连接问题与调试技巧
连接SQLite时最常见的错误是驱动类找不到和URL写错。ClassNotFoundException通常意味着sqlite-jdbc的jar包没有加入运行时类路径，或者Maven依赖没有正确下载。No suitable driver found则说明URL前缀不是jdbc:sqlite:，可能写成了jdbc:sqlite://或jdbc:sqlite:/这样的形式。
路径问题也经常导致连接失败。相对路径依赖当前工作目录，而IDE中运行程序时当前目录可能是项目根目录，命令行执行时则是命令所在目录。为了避免混淆，建议使用绝对路径，或者在配置文件中统一维护数据库文件位置。如果数据库文件所在目录不存在，SQLite不会自动创建父目录，需要提前用File.mkdirs创建。
当程序运行后无法打开数据库文件时，可以检查文件是否被其他进程占用。Windows下可以使用资源监视器查看句柄，Linux下使用lsof命令。SQLite驱动默认的busy timeout可能为0，也就是说一旦检测到锁会立即报错。可以通过SQLiteConfig或连接属性设置busy_timeout，例如在URL后添加?busy_timeout=3000，表示等待最多3秒。
调试SQL语句时，可以开启SQLite的日志或通过数据库文件直接查看表结构。工具方面，DB Browser for SQLite可以打开db文件并执行查询，适合验证JDBC操作结果。如果使用内存数据库测试，建议在连接后导出一份数据库副本，或使用jdbc:sqlite:file:testdb?mode=memory&cache=shared这样的特殊模式。
本文完整演示了Java JDBC连接SQLite数据库的主要步骤：引入驱动、建立连接、执行SQL、使用预编译语句和事务控制，并分析了常见问题。掌握这些内容后，可以把SQLite应用在小型项目中，用最少的外部依赖实现本地数据持久化。随着项目规模扩大，如果出现高并发写入需求，则需要评估迁移到MySQL或PostgreSQL等服务器型数据库。