Eclipse 项目中手动添加的 PostgreSQL JDBC JAR 虽已配置到构建路径，但运行时仍报 ClassNotFoundException，根本原因在于构建路径（Build Path）≠ 运行时类路径（Runtime Classpath），需确保 JAR 同时被 Eclipse 的启动配置识别。
eclipse 项目中手动添加的 postgresql jdbc jar 虽已配置到构建路径，但运行时仍报 `classnotfoundexception`，根本原因在于构建路径（build path）≠ 运行时类路径（runtime classpath），需确保 jar 同时被 eclipse 的启动配置识别。
在 Eclipse 中，“添加外部 JAR 到 Build Path”仅影响编译期依赖和 IDE 内部代码解析，并不自动将其包含在 Java 应用程序的运行时类路径中。这就是为什么 System.getProperty("java.class.path") 输出中缺失 PostgreSQL JAR，却仍能正常编译（IDE 编译器可见该库），而运行时却抛出 java.lang.ClassNotFoundException: org.postgresql.Driver。
✅ 正确解决步骤（无需重构项目）
确认 JAR 已正确添加至 Build Path
右键项目 → Properties → Java Build Path → Libraries 标签页 → 检查 PostgreSQL JDBC Driver (e.g., postgresql-42.7.3.jar) 是否存在且无黄色警告图标。若为“Missing JAR”，需重新指定绝对路径。-
关键：将 JAR 显式加入运行时类路径
- 点击 Run → Run Configurations…
- 选择对应 Java Application 配置（如 MyApp）→ 切换到 Classpath 标签页
- 在 User Entries 区域点击 Add External JARs…，再次选择同一 PostgreSQL JAR 文件
- ✅ 确保该 JAR 出现在 User Entries 下（而非仅在 Bootstrap Entries 或 Plug-in Dependencies）
- 点击 Apply → Run
? 小技巧：也可在 Classpath 标签页中展开 Bootstrap Entries → 右键 JRE System Library → Add External JARs…，但更推荐统一放在 User Entries，便于版本管理和调试。
-
验证运行时类路径
在主方法开头添加以下代码并运行：String cp = System.getProperty("java.class.path"); System.out.println("Runtime Classpath:\n" + cp.replaceAll(";", "\n"));确认输出中包含 PostgreSQL JAR 的完整绝对路径。
Eclipse IDE下载Eclipse IDE 是一款由 Eclipse 基金会管理的开源、跨平台集成开发环境。其核心基于 Java 构建，通过强大的插件架构可扩展支持 C/C++、Python、PHP 等多种编程语言。它提供丰富的代码编辑、调试和重构工具，并紧密集成 Git、Maven 等现代开发工具链，是全球众多开发者首选的 Java 开发利器。
⚠️ 注意事项与常见陷阱
不要依赖“Copy to project folder”自动处理：即使勾选了 Copy the JAR to project（在 Add External JARs 对话框中），Eclipse 也不会自动将其加入运行时类路径，仍需手动配置 Run Configuration。
-
Maven/Gradle 是更优解（长期建议）
如答案所建议，使用构建工具可彻底规避此类问题：<!-- Maven pom.xml --> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>42.7.3</version> </dependency>Eclipse 通过 m2e 插件自动同步依赖——编译、运行、打包全部一致，且支持版本管理、依赖传递与跨环境一致性。
避免混用多种引入方式：同一 JAR 不要在 Build Path 和 Run Configuration 中重复添加不同路径（如一个用相对路径、一个用绝对路径），易引发冲突或加载失败。
✅ 总结
手动添加 JAR 后仍报 ClassNotFoundException，本质是 Eclipse 分离了编译路径与运行路径。修复核心在于：确保该 JAR 同时出现在 Build Path 的 Libraries 中，并显式添加到 Run Configuration 的 User Entries 类路径下。 对于新项目，强烈推荐采用 Maven 或 Gradle 管理依赖——一次声明，处处生效，真正实现“写一次，跑 everywhere”。
