VSCode中JDBC连接PostgreSQL遇类加载及驱动问题求助

当前目录结构 #

.
├── DateBox.java
├── FamilyCalendar.java
├── PostgresWithJDBCConnection.class
├── PostgresWithJDBCConnection.java
├── PostgresWithJDBCDelete.java
├── PostgresWithJDBCInsert.java
├── PostgresWithJDBCSelect.java
├── PostgresWithJDBCUpdate.java
├── StringManager.java
└── postgresql-42.6.0.jar

核心测试代码（PostgresWithJDBCConnection.java） #

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class PostgresWithJDBCConnection {
    public static void main(String[] args) {

        try (Connection connection = DriverManager.getConnection("jdbc:postgresql://127.0.0.1:5432/dob", "dob",
                "MY_PASSWD")) {
            System.out.println("Connection established successfully");
        } catch (SQLException e) {
            System.out.print(e.getMessage());
        }
    }
}

问题分析 #

1. 终端执行报错：Error: Could not find or load main class PostgresWithJDBCConnection #

执行的java命令仅指定了JDBC jar包作为类路径，未包含当前目录（.class文件所在路径），导致JVM无法定位主类文件。

2. VSCode UI执行报错：No suitable driver found for jdbc:postgresql://127.0.0.1:5432/dob #

VSCode默认的运行命令未将JDBC jar包加入类路径，编译和运行过程中都无法加载PostgreSQL驱动类。

为何Ubuntu环境可正常运行？ #

大概率是Ubuntu系统中JDBC jar包被放置到了JRE的ext扩展目录，或者系统环境变量CLASSPATH默认包含了当前目录与jar包路径，而macOS环境无此默认配置。

解决方法 #

终端方式修正 #

编译与运行时，需同时将当前目录（.）和JDBC jar包加入类路径：

# 编译命令
javac -cp ".:postgresql-42.6.0.jar" PostgresWithJDBCConnection.java
# 运行命令
java -cp ".:postgresql-42.6.0.jar" PostgresWithJDBCConnection

注：Windows系统下类路径分隔符为;，macOS/Linux为:

VSCode UI方式修正 #

修改VSCode的Java运行配置，将JDBC jar包加入类路径：

1. 点击右上角运行按钮旁的下拉箭头，选择「添加配置」
2. 在生成的launch.json中添加如下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "PostgresWithJDBCConnection",
            "request": "launch",
            "mainClass": "PostgresWithJDBCConnection",
            "classpath": ["${workspaceFolder}", "${workspaceFolder}/postgresql-42.6.0.jar"]
        }
    ]
}

保存后重新运行即可。

另一种简便方式：右键目录中的postgresql-42.6.0.jar，选择「添加到项目依赖」，VSCode会自动处理类路径配置。

内容的提问来源于stack exchange，提问作者Ahn Jun-Yeong