Docker运行Spring Boot应用遇java.lang.UnsatisfiedLinkError错误求助

问题原因 #

你使用的eclipse-temurin:17-jdk-alpine基于Alpine Linux，该系统采用musl libc而非Java AWT组件依赖的GNU glibc，且Alpine默认缺失X11图形环境相关组件，导致libawt_xawt.so无法加载。从堆栈跟踪可看出，问题触发点是代码调用java.awt.Desktop.getDesktop()时的AWT初始化流程。

具体解决方案 #

方案1：禁用AWT/Desktop功能（推荐，Docker环境无需图形交互） #

Docker容器内没有桌面环境，打开浏览器等图形逻辑本身无法生效，可通过两种方式处理：

• 修改代码：删除com.docusign.App.openHomePage方法中调用Desktop.getDesktop()的相关逻辑。
• 添加JVM启动参数：若暂时无法修改代码，在Dockerfile的启动命令中加入-Djava.awt.headless=true，强制Java在无头模式下运行，跳过AWT组件初始化：

  FROM eclipse-temurin:17-jdk-alpine
  VOLUME /tmp
  ARG JAR_FILE=target/*.jar
  COPY ${JAR_FILE} app.jar
  ENTRYPOINT ["java","-Djava.awt.headless=true","-jar","/app.jar"]
  

方案2：更换基于GNU glibc的JDK镜像 #

如果必须保留AWT功能，放弃Alpine镜像，改用基于Debian/Ubuntu的官方JDK镜像，这类镜像默认包含glibc及AWT所需依赖：

FROM eclipse-temurin:17-jdk-focal
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

方案3：在Alpine镜像中手动安装依赖（不推荐，配置复杂） #

若坚持使用Alpine镜像，需安装glibc兼容层及X11相关库：

FROM eclipse-temurin:17-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar

# 安装依赖组件
RUN apk add --no-cache \
    libx11 \
    libxext \
    libxrender \
    libxtst \
    libxi \
    && wget -q -O /etc/apk/keys/sgerrand.rsa.pub https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub \
    && wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.35-r0/glibc-2.35-r0.apk \
    && apk add glibc-2.35-r0.apk \
    && rm -f glibc-2.35-r0.apk

COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

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