如何建立独立于IDE与上级目录的SQLite JDBC相对路径连接

方案一：基于项目工作目录的动态路径推荐用于可读写数据库 #

这种方式依赖Java进程的工作目录，Maven项目无论用mvn exec:java运行，还是主流IDE（IntelliJ/Eclipse）默认配置运行，工作目录都是项目根目录，能保证跨环境一致性。

import java.sql.Connection;
import java.sql.DriverManager;
import java.nio.file.Path;
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) {
        Connection connection = null;
        try {
            // 获取当前Java进程的工作目录（即项目根目录）
            String projectRoot = System.getProperty("user.dir");
            // 拼接数据库文件的绝对路径
            Path dbPath = Paths.get(projectRoot, "database", "data.db");
            String url = "jdbc:sqlite:" + dbPath.toAbsolutePath();
            
            connection = DriverManager.getConnection(url);
            System.out.println("数据库连接成功");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 关闭连接
            try {
                if (connection != null) connection.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

说明：

• System.getProperty("user.dir")会返回项目根目录路径，不受IDE和上级目录位置影响
• 部署到服务器时，只需保证database目录与jar包放在同一级目录下，即可正常连接

方案二：基于类路径的资源读取推荐用于只读数据库 #

如果数据库是只读的，可以将database目录移到src/main/resources下（Maven标准资源目录），打包时会自动纳入classpath，适合需要将数据库随jar包分发的场景。

调整后的项目结构：

java_project
├───src
│   └───main
│       ├───java
│       │   └───Main.java
│       └───resources
│           └───database
│               └───data.db
└───pom.xml

连接代码：

import java.sql.Connection;
import java.sql.DriverManager;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        Connection connection = null;
        try {
            // 从类路径加载数据库文件
            URL dbResourceUrl = Main.class.getClassLoader().getResource("database/data.db");
            if (dbResourceUrl == null) {
                throw new RuntimeException("未在类路径中找到数据库文件");
            }
            // 处理URL路径的转义字符（如空格），并适配SQLite的JDBC格式
            String dbPath = dbResourceUrl.getPath().replace("%20", " ");
            String url = "jdbc:sqlite:" + dbPath;
            
            connection = DriverManager.getConnection(url);
            System.out.println("数据库连接成功");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 关闭连接
            try {
                if (connection != null) connection.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

注意：类路径中的文件是只读的，如果需要对数据库进行写入操作，不要用这种方式。

为什么你之前的相对路径无效？ #

你尝试的../../../database/data.db路径依赖编译后的class文件位置，不同IDE的编译输出目录（如IntelliJ的target/classes、Eclipse的bin）不同，路径层级会变化，导致无法定位到数据库文件。而动态获取工作目录的方式完全脱离了文件层级的依赖，更可靠。

另外，$PROJECT_DIR$是IntelliJ专属的运行配置变量，Java代码无法直接识别，所以不能用于跨环境场景。

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