Docker打包Spring Boot应用集成otel-javaagent启动报错求助

问题根源分析 #

从报错和构建日志来看，核心问题大概率是Docker缓存导致旧的损坏/不完整的Agent Jar被复用，或是JAVA_TOOL_OPTIONS的参数传递存在隐性解析问题。

具体修复方案 #

1. 强制重新下载完整的Agent Jar #

构建日志显示ADD步骤被缓存，可能之前下载的Jar文件损坏或不完整。替换ADD命令为curl强制下载，避免缓存复用：

FROM maven:3.8.3-amazoncorretto-17

RUN mkdir -p /agent
# 使用curl强制下载，--fail参数会在下载失败时终止构建
RUN curl -L --fail -o /agent/opentelemetry-javaagent.jar \
    https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

ENV JAVA_TOOL_OPTIONS="-javaagent:/agent/opentelemetry-javaagent.jar \
-Dotel.traces.exporter=xray \
-Dotel.metrics.exporter=none"

VOLUME /srv/logs

ARG JAR_FILE
COPY ${JAR_FILE} device-backend.jar
ENTRYPOINT ["java","-jar","/device-backend.jar"]

2. 跳过环境变量，直接在ENTRYPOINT指定Agent参数 #

绕过JAVA_TOOL_OPTIONS的隐性解析问题，直接在启动命令中传递Agent参数：

FROM maven:3.8.3-amazoncorretto-17

RUN mkdir -p /agent
ADD https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar /agent/opentelemetry-javaagent.jar

VOLUME /srv/logs

ARG JAR_FILE
COPY ${JAR_FILE} device-backend.jar
# 直接在启动命令中指定Agent和配置参数
ENTRYPOINT ["java", "-javaagent:/agent/opentelemetry-javaagent.jar", "-Dotel.traces.exporter=xray", "-Dotel.metrics.exporter=none", "-jar", "/device-backend.jar"]

3. 构建时验证Agent Jar完整性 #

在Dockerfile中添加校验步骤，确保Jar文件有效，构建阶段就能发现问题：

FROM maven:3.8.3-amazoncorretto-17

RUN mkdir -p /agent
ADD https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar /agent/opentelemetry-javaagent.jar
# 验证Jar文件是否可正常读取，失败则终止构建
RUN jar tf /agent/opentelemetry-javaagent.jar > /dev/null || (echo "Agent Jar已损坏" && exit 1)

ENV JAVA_TOOL_OPTIONS="-javaagent:/agent/opentelemetry-javaagent.jar \
-Dotel.traces.exporter=xray \
-Dotel.metrics.exporter=none"

VOLUME /srv/logs

ARG JAR_FILE
COPY ${JAR_FILE} device-backend.jar
ENTRYPOINT ["java","-jar","/device-backend.jar"]

4. 清理Docker缓存后重新构建 #

如果之前的缓存层已损坏，先清理本地缓存再重新构建：

# 清理停止的容器和悬空镜像
docker system prune -f
# 禁用缓存重新构建镜像
docker build --no-cache -t your-image-name .

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