Docker镜像在Windows构建正常但Linux构建失败（Spring Boot + Kafka）

这种跨环境构建出问题的情况确实挺棘手的，结合你描述的现象和限制（封闭网络无法共享代码），我来梳理下最可能的原因和可行的调试方向：

一、最可能的根源分析 #

1. 文件系统大小写敏感性差异 #

Windows默认是大小写不敏感的文件系统，而Linux是严格区分大小写的。这很可能是核心问题：

• 代码中引用的类名、配置文件名或资源路径在Windows下忽略大小写能正常找到，但Linux下因为大小写不匹配导致加载失败。比如代码里写了import aggregations.processors.Somename，但实际类文件是SomeName.class，Windows构建打包时没问题，Linux构建或运行时就会找不到类，最终引发Bean初始化失败。
• 配置文件中的路径配置（比如Kafka的证书路径、自定义资源路径）如果写了大小写不一致的路径，Windows下能识别，Linux下则会找不到文件。

2. Maven构建的环境/配置差异 #

即使你确认jar文件“看起来正确”，但Windows和Linux下Maven构建的细节可能有差异：

• Profile激活差异：如果你的pom.xml中有环境相关的Profile，Windows和Linux下可能因为环境变量、系统属性不同激活了不同的Profile，导致打包的配置文件或依赖有差异。比如Windows下激活了devProfile，Linux下默认激活了prod，而prod的Kafka配置存在问题。
• 资源文件过滤差异：Maven的资源过滤（resource filtering）在不同系统下可能因为路径分隔符、环境变量取值不同，导致最终打包的配置文件内容不一致。比如配置中的${user.home}在Windows和Linux下取值完全不同，如果代码依赖这个路径就会出问题。
• 换行符问题：Windows下的配置文件是CRLF换行，Linux下是LF。虽然Spring通常能兼容，但某些情况下（比如配置值末尾有换行）会导致参数解析错误，进而影响Kafka Streams的初始化。

3. Docker构建上下文的细微差异 #

Docker构建时的上下文内容在Windows和Linux下可能有区别：

• 忽略文件规则差异：.gitignore或.dockerignore中的规则在Windows和Linux下可能表现不同，导致某些文件被意外包含或排除。比如Windows下target/不会被忽略，但Linux下被忽略，导致Docker构建时复制了旧的jar文件。
• 路径分隔符问题：如果Dockerfile中使用了Windows风格的路径分隔符\，在Linux构建时会解析错误，导致COPY/ADD步骤出现异常（不过通常Dockerfile要求用/，但偶尔会有疏忽）。

二、分步调试方案 #

1. 对比两个环境的jar包内容 #

这是最直接的排查方式：

• 分别将Windows和Linux构建出的jar包解压到两个目录：

  unzip -q -d win-built-jar /path/to/windows/kafka.jar
  unzip -q -d linux-built-jar /path/to/linux/kafka.jar
  

• 用差异对比工具检查两个目录的内容：

  diff -r win-built-jar linux-built-jar
  

  重点关注：
  • BOOT-INF/classes/下的配置文件（application.yml、application.properties等）内容是否一致
  • 相关处理器类（比如aggregations/processors/someName.class）是否存在，大小写是否匹配
  • META-INF/maven/下的pom.xml快照是否一致，确认Profile激活情况

2. 直接在Linux上运行Linux构建的jar包 #

跳过Docker，直接用Java命令运行Linux构建的jar：

java -jar /path/to/linux/kafka.jar

如果运行失败，说明问题出在Maven构建环节，而非Docker；如果运行正常，再聚焦到Docker构建过程。

3. 查看容器启动的完整异常栈 #

你提供的错误信息只到“message: null”，NullPointerException的具体位置是关键。可以：

• 启动容器时开启Spring的调试日志：

  docker run -e LOGGING_LEVEL_ORG_SPRINGFRAMEWORK=DEBUG your-image-name
  

• 查看完整的异常栈，找到NullPointerException的根源（比如是Kafka配置未加载、某个依赖Bean未初始化等）。

4. 检查Dockerfile的构建步骤 #

仔细核对Dockerfile的每一步：

• 确认基础镜像是否一致（比如是否都是openjdk:17-jre-slim）
• 检查COPY/ADD步骤的路径是否正确，是否存在大小写问题
• 如果是多阶段构建，确认Maven构建阶段的命令在Linux下是否正常（比如mvn clean package -DskipTests是否在Linux环境下能正确执行）

5. 验证文件大小写问题 #

进入Linux构建的容器内部，检查jar包中的文件路径：

docker exec -it your-container-id bash
# 进入容器后，用unzip查看jar内的文件列表
unzip -l /app/target/kafka.jar | grep "someName.class"

确认文件路径的大小写是否和代码中的引用完全一致。

备注：内容来源于stack exchange，提问作者Amit Yaari