Eclipse将JAR添加到构建路径（Build Path）后，编译可能通过，但运行时仍抛出ClassNotFoundException，根本原因在于构建路径≠运行时类路径——尤其在未正确配置启动配置（Run Configuration）或项目依赖作用域时，JAR不会自动出现在java.class.path中。
eclipse将jar添加到构建路径（build path）后，编译可能通过，但运行时仍抛出`classnotfoundexception`，根本原因在于构建路径≠运行时类路径——尤其在未正确配置启动配置（run configuration）或项目依赖作用域时，jar不会自动出现在`java.class.path`中。
在您描述的场景中，PostgreSQL JDBC驱动（如 postgresql-42.x.x.jar）虽已通过 Project → Properties → Java Build Path → Libraries → Add External JARs 成功添加，但运行时却提示 java.lang.ClassNotFoundException: org.postgresql.Driver，且 System.getProperty("java.class.path") 输出中缺失该JAR——这明确表明：JAR未被纳入JVM实际启动的类路径（runtime classpath）。
? 根本原因分析
Eclipse 的“Build Path”仅控制编译期依赖和默认运行时类路径，但以下情况会导致运行时类路径失效：
- 项目使用了自定义 Run Configuration（如独立的 Java Application 启动项），而该配置未继承项目构建路径；
- JAR被添加为 "Library" 类型但未勾选 "Add to build path" 或未启用 "Export"（右键JAR → Build Path → Configure Build Path → Order and Export 中未勾选对应条目）；
- 项目为 Dynamic Web Project 或含 MANIFEST.MF，但未将JAR放入 WEB-INF/lib 或未声明 Class-Path；
- 工作区元数据损坏（.project、.classpath 文件异常）或 Eclipse 缓存未刷新。
✅ 快速验证与修复步骤
检查导出状态（关键！）
进入 Project Properties → Java Build Path → Order and Export，确保 PostgreSQL JAR 前方复选框已被勾选（✅）。若未勾选，Eclipse 不会将其传递给运行时类加载器。-
验证 Run Configuration
- 右键项目 → Run As → Run Configurations…
- 选择对应启动项 → 切换到 Classpath 选项卡 → 展开 User Entries
- 确认 PostgreSQL JAR 是否在此列表中；若缺失，点击 Advanced → Add External JARs… 手动添加。
-
刷新与重建
# 清理并重建项目（强制更新 .classpath 和启动配置） Project → Clean → 选择当前项目 → OK
同时删除 bin/ 或 target/ 目录（如有），避免旧字节码干扰。
-
检查 .classpath 文件（底层验证）
在项目根目录打开 .classpath，确认包含类似条目：<classpathentry kind="lib" path="/path/to/postgresql-42.7.3.jar" exported="true"/>
exported="true" 是运行时生效的关键属性。
Eclipse IDE下载Eclipse IDE 是一款由 Eclipse 基金会管理的开源、跨平台集成开发环境。其核心基于 Java 构建，通过强大的插件架构可扩展支持 C/C++、Python、PHP 等多种编程语言。它提供丰富的代码编辑、调试和重构工具，并紧密集成 Git、Maven 等现代开发工具链，是全球众多开发者首选的 Java 开发利器。
⚠️ 注意事项与最佳实践
-
手动管理JAR易出错：如问题答案所建议，强烈推荐迁移到 Maven 或 Gradle。例如 Maven 的 pom.xml 只需声明：
<dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>42.7.3</version> </dependency>Eclipse 通过 m2e 插件自动同步依赖，exported 和 runtime classpath 由构建工具统一管理，彻底规避手动配置疏漏。
避免绝对路径陷阱：外部JAR若使用绝对路径（如 C:/libs/postgresql.jar），团队协作或换机时易失效。Maven/Gradle 使用坐标管理，本地仓库路径由工具自动解析。
SDKMAN辅助环境管理：配合 SDKMAN! 可一键切换 JDK、Maven、Gradle 版本，保障构建一致性，尤其适用于多版本JDBC驱动测试场景（如兼容 PostgreSQL 12/15/16）。
? 总结
Eclipse 中“添加到构建路径”不等于“加入运行时类路径”。务必检查 Order and Export 设置 和 Run Configuration 的 Classpath。长期来看，采用 Maven/Gradle 不仅能根治此类问题，还能提升依赖可维护性、构建可重复性及团队协作效率——让开发聚焦业务逻辑，而非类路径调试。
