打包为可执行JAR后，如何使用SQLite(3)连接数据库？

这是个开发者常踩的坑——IDE里运行一切正常，打包成JAR就报错，核心原因在于文件路径的本质变化：

在IntelliJ中，src/files/sample.db是本地文件系统上的真实文件，DriverManager可以直接通过路径访问；但打包成JAR后，这个数据库文件是嵌入到JAR包内部的资源，不再是独立的文件，直接用原路径自然找不到。

解决步骤 #

1. 先确认资源打包正确

首先要保证sample.db被正确打包进JAR：

• 在IntelliJ中，把src/files目录标记为「Resources Root」（右键目录 → Mark Directory as → Resources Root）。
• 打包后可以用命令jar tf your-app.jar查看JAR内部结构，确认files/sample.db存在于JAR根目录下。

2. 修改连接逻辑：复制嵌入式资源到临时文件

SQLite驱动需要对数据库文件进行随机读写，而JAR内部的资源是只读的流，无法直接作为数据库文件使用。所以我们需要把内置的sample.db复制到系统临时目录，再连接这个临时文件。

下面是修改后的代码示例：

private Connection getConnection() throws SQLException, IOException {
    // 处理用户选择的数据库
    if (selectedDB != null && !selectedDB.trim().isEmpty()) {
        return DriverManager.getConnection("jdbc:sqlite:" + selectedDB);
    }

    // 处理内置示例数据库
    try (InputStream dbResource = getClass().getResourceAsStream("/files/sample.db")) {
        if (dbResource == null) {
            throw new IOException("内置示例数据库未找到，请检查打包配置");
        }

        // 创建临时文件，JVM退出时自动删除
        File tempDb = File.createTempFile("sample", ".db");
        tempDb.deleteOnExit();

        // 将资源流复制到临时文件
        try (FileOutputStream outputStream = new FileOutputStream(tempDb)) {
            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = dbResource.read(buffer)) != -1) {
                outputStream.write(buffer, 0, bytesRead);
            }
        }

        // 连接临时文件
        return DriverManager.getConnection("jdbc:sqlite:" + tempDb.getAbsolutePath());
    }
}

关键细节说明 #

• getClass().getResourceAsStream("/files/sample.db")：通过类加载器读取JAR内部的资源，路径开头的/表示从JAR根目录开始查找，对应打包后的资源结构。
• 临时文件的deleteOnExit()：确保程序退出时自动清理临时文件，避免残留垃圾。
• 如果你的示例数据库是只读的，可以考虑把临时文件设为只读，但复制到临时文件的方式依然是必要的，因为SQLite需要文件系统级别的访问。

额外配置检查（Maven/Gradle）

如果用构建工具打包，要确保资源目录被正确包含：

• Maven：在pom.xml中添加资源配置：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
        <!-- 如果你的files目录在src下，添加下面的配置 -->
        <resource>
            <directory>src/files</directory>
            <targetPath>files</targetPath>
        </resource>
    </resources>
</build>

• Gradle：在build.gradle中添加：

sourceSets {
    main {
        resources {
            srcDirs = ["src/main/resources", "src/files"]
        }
    }
}

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