Docker Swarm运行Spring Boot应用找不到PostgreSQL驱动类如何解决

问题根因分析 #

最常见原因：Docker Swarm镜像拉取策略差异 #

docker-compose up默认优先使用本地已构建的镜像，而docker stack deploy默认对latest标签的镜像强制从远程镜像仓库拉取。如果你本地构建的包含PostgreSQL依赖的镜像没有推送到远程仓库，Swarm会拉取到远程仓库中旧版本、未包含PG依赖的镜像，从而抛出驱动类找不到的错误。

其他可能原因 #

• 环境变量存在不可见字符：docker-compose.yml中配置的spring.datasource.driver-class-name环境变量可能携带多余空格、换行符，导致Spring Boot读取到的类名不符合预期
• 自定义类路径覆盖：Dockerfile或者Swarm配置中自定义了CLASSPATH环境变量，覆盖了Spring Boot默认的类加载路径，导致无法加载BOOT-INF/lib下的PG依赖

解决方案 #

1. 优先修正镜像拉取策略（90%以上的场景可解决此问题） #

• 给本地镜像打唯一非latest标签，避免默认拉取远程镜像：

docker build -t your-app-image:v1 .

• 在docker-compose.yml的服务配置中新增拉取策略配置，优先使用本地镜像：

services:
  your-service-name:
    image: your-app-image:v1
    pull_policy: if_not_present
    # 其余原有配置保持不变

• 重新执行部署命令即可：

docker stack deploy --compose-file docker-compose.yml compose

2. 排查环境变量格式问题 #

在Spring Boot启动类中增加调试日志，打印实际读取到的驱动类配置，确认没有多余字符：

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        ConfigurableApplicationContext ctx = SpringApplication.run(YourApplication.class, args);
        Environment env = ctx.getEnvironment();
        // 打印时增加括号包裹，方便识别是否有隐藏空格
        System.out.println("读取到的驱动类：[" + env.getProperty("spring.datasource.driver-class-name") + "]");
    }
}

如果存在多余字符，修正docker-compose.yml中的环境变量配置即可。

3. 排查类路径配置 #

检查Dockerfile中是否存在自定义CLASSPATH的配置，或者启动命令中是否有-classpath/-cp参数，如果有则删除自定义配置，使用Spring Boot默认的java -jar your-app.jar启动方式即可。

额外提示 #

你当前配置的数据源URLjdbc:postgresql://localhost:5432/service在Swarm模式下无法正常访问数据库，容器内的localhost指向容器自身而非宿主机，后续驱动问题解决后需要将PostgreSQL服务部署到同一个Swarm Overlay网络中，将URL改为jdbc:postgresql://<PG服务名>:5432/service即可正常连接。

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