如何在Maven项目中配置SQLite数据库并解决相对路径失效问题

我来帮你搞定这个问题——你遇到的核心问题是混淆了文件系统的相对路径和Classpath资源路径，同时没考虑Maven项目资源文件的编译后位置以及打包成Jar后的访问限制。

为什么你的相对路径不行？ #

你用的"/database/ExtraInfo.db"是文件系统根目录的绝对路径（开头的斜杠表示系统根目录），不是相对于项目或Classpath的路径，所以程序会去系统根目录找这个文件夹，自然找不到你放在src/main/resources里的文件。

正确的解决方案分两种场景： #

1. 本地开发调试阶段（IDE中运行）

Maven会把src/main/resources下的文件编译到target/classes目录，这个目录属于Classpath的一部分。你可以通过类加载器获取资源的真实路径：

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;

// 获取Classpath中的数据库资源
URL resourceUrl = getClass().getResource("/database/ExtraInfo.db");
if (resourceUrl == null) {
    throw new RuntimeException("找不到数据库文件，请检查src/main/resources/database/ExtraInfo.db是否存在");
}

// 转换为文件系统路径，注意解码URL中的特殊字符（比如空格）
String dbFilePath = URLDecoder.decode(resourceUrl.getPath(), StandardCharsets.UTF_8);

// 构建SQLite JDBC URL
String url = "jdbc:sqlite:" + dbFilePath;

这段代码会自动适配你IDE中的项目结构，不管你在哪个目录运行程序，都能找到正确的文件。

2. 生产环境（打包成Jar文件后运行）

如果把项目打包成Jar，src/main/resources里的文件会被打包到Jar内部，而SQLite无法直接访问Jar包内的文件（因为Jar是压缩包，SQLite需要随机读写）。这时需要把数据库文件复制到外部可读写的目录：

import java.io.*;
import java.net.URL;

// 选择一个外部可读写的目录，比如用户主目录下的专属文件夹
File externalDbDir = new File(System.getProperty("user.home") + "/your-app-name/database");
externalDbDir.mkdirs(); // 创建目录（如果不存在）

File targetDbFile = new File(externalDbDir, "ExtraInfo.db");

// 如果外部文件不存在，从Jar中复制原文件
if (!targetDbFile.exists()) {
    try (InputStream inputStream = getClass().getResourceAsStream("/database/ExtraInfo.db");
         OutputStream outputStream = new FileOutputStream(targetDbFile)) {
        
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }
    } catch (IOException e) {
        throw new RuntimeException("复制数据库文件到外部目录失败", e);
    }
}

// 连接外部的数据库文件
String url = "jdbc:sqlite:" + targetDbFile.getAbsolutePath();

这样打包后运行程序，会自动把数据库文件复制到用户主目录的指定文件夹，保证SQLite可以正常读写。

关键知识点总结 #

• Maven项目中，src/main/resources下的资源编译后会进入Classpath根目录，不能用文件系统相对路径直接访问。
• 类加载器的getResource("/xxx")或getResourceAsStream("/xxx")是访问Classpath资源的标准方式。
• Jar包内的资源是只读的，SQLite需要可写文件时，必须复制到外部目录。

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