基于Tomcat的Docker镜像仅在Linux系统部署war包失败问题求助

1. 优先排查大小写敏感问题 #

Linux文件系统默认大小写敏感，macOS/Windows默认关闭大小写敏感，这是跨平台部署最常见的差异点：

• 检查war包中报错对应的包路径下，是否存在jaxb.index、ObjectFactory.class文件，确认文件名大小写完全匹配代码中的引用路径
• 检查Spring配置文件（对应日志中的web-application-config.xml、webmvc-config.xml）中涉及JAXB扫描的包路径、类名大小写是否和实际文件结构完全一致

2. 补全JDK11缺失的JAXB依赖 #

JDK11已经将JAXB相关模块从标准库中移除，若你的war包未内置对应依赖，会出现类找不到的错误：

• 确认war包的WEB-INF/lib目录下是否包含JAXB必要依赖：jaxb-api、jaxb-impl、jaxb-core、activation，若缺失将上述依赖打包进war包即可解决
• 若不想修改war包，也可以直接修改Dockerfile，在基础镜像中安装对应依赖并调整启动参数：

  FROM tomcat:8.5-jre11-openjdk-slim
  # 新增：安装JAXB相关依赖
  RUN apt-get update && apt-get install -y --no-install-recommends \
      libjaxb-api-java \
      libjaxb-impl-java \
      && rm -rf /var/lib/apt/lists/*
  
  ENV JAVA_OPTS="-Xmx10G -Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8 --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-modules java.xml.bind"
  
  COPY webapp.war /usr/local/tomcat/webapps/
  

3. 排查Docker镜像架构一致性问题 #

macOS若为M系列芯片设备，Docker默认拉取arm64架构镜像，Windows/Linux多为x86_64架构，不同架构的openjdk镜像内置的模块可能存在差异：

• 构建镜像时显式指定架构，避免架构差异导致的依赖缺失：

  docker buildx build --platform linux/amd64 -t your-image-name .
  

  也可以在docker-compose.yaml中新增platform配置：

  version: "3"
  services: 
      webapp:
          container_name: mytool
          build: webapp
          platform: linux/amd64
          ports: 
              - "8080:8080"
  

4. 调整JVM模块开放参数 #

你当前的JAVA_OPTS只开放了jdk.internal.loader模块，JAXB运行还需要额外的模块权限，在JAVA_OPTS中新增以下参数：

--add-opens=java.xml.bind/javax.xml.bind=ALL-UNNAMED

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