Eclipse+Gradle环境下PostgreSQL JDBC驱动未自动下载问题排查

以下是几种常见的原因和对应的解决方式：

• 未手动触发Gradle依赖同步
  Eclipse的Gradle插件不会实时自动同步所有依赖变更。右键你的项目，选择「Gradle」→「Refresh Gradle Project」，或者在Gradle视图中点击刷新按钮，强制同步依赖。如果用命令行，执行./gradlew build --refresh-dependencies（Windows系统用gradlew.bat build --refresh-dependencies）。

• Maven Central仓库访问异常
  虽然你的build.gradle配置了mavenCentral()，但网络波动、代理设置错误或仓库访问受限都可能导致依赖下载失败。

  1. 检查Eclipse的网络代理设置：打开「Window」→「Preferences」→「General」→「Network Connections」，确认代理配置能正常访问外部网络。
  2. 可以替换为国内Maven镜像加速下载，修改repositories块：

     repositories {
         maven { url 'https://maven.aliyun.com/repository/public/' }
         mavenCentral()
     }
     

• Eclipse Buildship插件版本过低
  旧版Buildship插件对Gradle的依赖解析支持可能存在缺陷。打开「Help」→「Eclipse Marketplace」，搜索「Buildship Gradle Integration」，更新到最新版本后再同步依赖。

• 本地Gradle缓存损坏
  Gradle会将下载的依赖存储在本地缓存目录（默认路径：Windows为C:\Users\<用户名>\.gradle\caches，Linux/macOS为~/.gradle/caches），如果缓存文件损坏或不完整，会导致Gradle不再尝试重新下载。删除该缓存目录后，重新执行依赖同步即可。

• 依赖坐标验证
  虽然你的依赖坐标org.postgresql:postgresql:42.4.0是正确的，但可以通过执行./gradlew dependencies命令查看项目依赖树，确认该依赖是否被正确识别。如果依赖树中没有显示PostgreSQL驱动，检查坐标是否存在拼写错误。

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