Java JAR在Docker Desktop正常运行，同镜像部署Linux却失败

我在基于Maven的Docker镜像中运行Java应用，在Docker Desktop上操作完全正常：

1. 进入容器
2. 执行mvn package构建JAR包
3. 通过java -jar myapp.jar成功运行

但在Linux机器上运行同一Docker镜像，执行完全相同步骤时，JAR运行失败，报错：

Error creating bean with name 'someName' defined in URL [jar:nested:/app/target/kafka.jar/!BOOT-INF/classes/!/aggregations/processors/someName.class]: Unsatisfied dependency expressed through constructor parameter 0: Error creating bean with name 'someName2' defined in class path [org/springframework/kafka/annotations/someName2.class]: Failed to instantiate [org.springframework.kafka.config.someName2]: Factory method 'defaultKafkaStreamsBuilder' threw exception with message: null

已完成的排查：

• 镜像完全一致（docker image ls显示相同镜像ID）
• 容器架构相同（uname -m均返回x86_64）
• Java版本一致（java -version结果相同）
• JAR包文件结构一致（jar tvf myapp.jar输出无差异）
• Maven版本相同（mvn -version结果一致）
• JAR包权限正常（ls -l myapp.jar确认权限无问题）

异常现象：

• Docker Desktop内构建的JAR复制到Linux容器中可正常运行
• Linux容器内构建的JAR在本地运行失败

核心差异在于构建环境的底层系统差异（Docker Desktop容器依赖macOS/Windows虚拟化内核，Linux机器为原生Linux内核），即使镜像、工具版本一致，仍可能存在以下隐性问题：

1. Maven构建插件的系统依赖差异 #

部分Maven插件（如与系统交互的打包插件、原生代码编译插件）在不同内核环境下的执行逻辑可能存在细微差异：

• 对比Docker Desktop和Linux容器内的mvn package完整日志，查找警告、插件执行差异或资源生成区别
• 检查pom.xml中是否使用了依赖系统底层的插件，尝试固定插件版本或显式配置插件参数

2. Spring Kafka Streams初始化的环境依赖 #

报错指向defaultKafkaStreamsBuilder初始化失败，这可能和构建时注入的系统属性/环境变量有关：

• 排查Docker Desktop容器与Linux容器的环境变量差异（执行env命令对比），将缺失的变量添加到Linux容器后重新构建
• 检查构建命令是否带有-D系统属性参数，确保Linux容器构建时传递相同参数

3. Maven本地仓库的缓存或依赖拉取差异 #

即使镜像一致，首次运行时Maven依赖的拉取源或缓存文件可能存在差异：

• 在Linux容器中执行mvn clean install -U强制更新依赖并重新构建，避免缓存的旧依赖影响
• 对比两地Maven仓库中依赖包的哈希值（如sha256sum ~/.m2/repository/xxx/yyy.jar），确认依赖完全一致

4. 文件系统的隐性元数据差异 #

虽然jar tvf显示JAR结构一致，但文件元数据（如修改时间、符号链接解析）可能因文件系统不同而存在差异：

• 在Linux容器构建时，确保执行mvn clean彻底清理之前的构建产物，避免残留文件干扰
• 尝试将Linux容器内的JAR解压后，与Docker Desktop构建的JAR解压文件对比元数据（如stat命令查看文件属性）

5. Spring Boot打包插件的行为差异 #

若使用spring-boot-maven-plugin打包，插件可能根据系统环境自动调整打包逻辑：

• 在pom.xml中显式配置插件的打包参数，比如：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <version>2.7.14</version> <!-- 固定稳定版本 -->
      <configuration>
          <layout>JAR</layout>
          <finalName>myapp</finalName>
      </configuration>
  </plugin>
  

• 重新构建后测试JAR运行情况

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