如何在Distroless Docker容器中集成JDK与Python venv解决JVM路径缺失问题

错误原因 #

该报错是由于你使用的Distroless容器未预装JDK运行环境，Python依赖库JPype查找JVM路径时，无法找到默认的/usr/lib/jvm目录导致执行失败。

修复方案 #

推荐使用多阶段Docker构建的方式，在不增大镜像冗余体积的前提下，将JDK、Python虚拟环境和你的应用代码一并打包到Distroless镜像中，具体操作如下：

• 第一阶段选择同时包含JDK和Python的官方镜像作为构建环境，完成虚拟环境创建、Python依赖安装、JDK文件预处理等操作
• 第二阶段选择带JRE的Distroless基础镜像，将构建阶段生成的必要文件拷贝进去即可
• 可以显式指定JVM路径，避免JPype自动查找失败

Dockerfile示例 #

# 第一阶段：构建层，完成依赖安装和预处理
FROM openjdk:17-jdk-slim-bookworm AS builder
# 安装Python基础环境
RUN apt update && apt install -y --no-install-recommends python3 python3-venv python3-pip && rm -rf /var/lib/apt/lists/*
# 创建并激活虚拟环境
RUN python3 -m venv /venv
ENV PATH="/venv/bin:$PATH"
# 安装Python依赖
RUN pip install --no-cache-dir --upgrade pip jpype1 sutime
# 预下载sutime所需的Java依赖包
RUN python -c "import sutime; sutime.SUTime(mark_time_ranges=True, include_range=True)"

# 第二阶段：运行层，使用Distroless镜像减少冗余
FROM gcr.io/distroless/java17-debian12
# 从构建层拷贝Python运行环境
COPY --from=builder /usr/bin/python3 /usr/bin/python3
COPY --from=builder /usr/lib/python3.11 /usr/lib/python3.11
COPY --from=builder /lib/x86_64-linux-gnu/libz.so.1 /lib/x86_64-linux-gnu/
# 拷贝虚拟环境
COPY --from=builder /venv /venv
# 拷贝JDK目录，满足JPype的路径查找要求
COPY --from=builder /usr/lib/jvm/java-17-openjdk-amd64 /usr/lib/jvm/java-17-openjdk-amd64
# 配置环境变量
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH="/venv/bin:$PATH"
# 拷贝业务代码
COPY . /app
WORKDIR /app
# 启动入口
CMD ["sutime_server.py"]

额外注意事项 #

• 如果构建后运行仍然提示找不到JVM路径，可以在代码中初始化SUTime之前手动指定JVM路径，示例如下：

import jpype
if not jpype.isJVMStarted():
    # 路径和你拷贝的JDK版本路径保持一致即可
    jpype.startJVM(jvm_path="/usr/lib/jvm/java-17-openjdk-amd64/lib/server/libjvm.so")

• 注意JDK版本要和你使用的Java模块兼容，优先选择JDK11、JDK17这类长期支持版本
• 如果运行时提示缺少系统动态链接库（.so文件），可以从构建层将对应文件拷贝到运行层的相同路径下
• 如果你使用的是ARM架构镜像，调整JDK路径中的架构后缀为对应值即可

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