Quarkus Docker应用本地与Kubernetes运行不一致问题求助

1. 核对Quarkus镜像构建模式 #

Quarkus分JVM和原生两种构建模式，官方通用Dockerfile会适配不同模式，先确认：

• 本地运行与K8s部署是否用的是同一种模式，避免本地跑JVM模式、K8s误部署原生模式镜像（反之亦然）
• 检查构建命令，比如JVM模式构建需执行./mvnw package -Dquarkus.container-image.build=true，原生模式要加-Dquarkus.native.container-build=true，确保K8s部署的镜像用了正确参数

2. 检查Kubernetes Pod的资源限制 #

Vertx初始化需要足够的内存和CPU，K8s默认资源限制可能不足：

• 查看Pod的resources配置，避免设置过低的内存/CPU请求或限制，示例合理配置：

  resources:
    requests:
      memory: "256Mi"
      cpu: "500m"
    limits:
      memory: "512Mi"
      cpu: "1"
  

• 执行kubectl describe pod <pod-name>查看Pod事件，确认是否有OOMKilled或资源不足的记录，内存不足会直接导致类加载失败

3. 验证镜像内的类路径完整性 #

本地正常但K8s异常，可能是镜像构建时遗漏了依赖：

• 进入Pod内部执行kubectl exec -it <pod-name> -- /bin/bash，查看lib目录下的依赖包，确认vertx-core-*.jar等Vertx相关jar包存在
• 对比本地运行时的类路径和Pod内的类路径，排查是否有依赖缺失

4. 检查Kubernetes的环境变量与配置 #

Quarkus配置在K8s中被覆盖可能导致Vertx初始化异常：

• 执行kubectl exec <pod-name> -- env查看Pod环境变量，检查QUARKUS_*开头的配置是否合理，比如QUARKUS_VERTX_MAX_EVENT_LOOP_THREADS是否设置错误
• 确认是否挂载了错误的application.properties等配置文件，覆盖了Vertx的默认初始化配置

5. 提取Pod完整错误日志 #

获取完整错误栈定位具体原因：

• 执行kubectl logs <pod-name> --all-containers查看完整启动日志，找到NoClassDefFoundError的完整堆栈，确认是依赖缺失还是类初始化时抛出异常
• 如果是类初始化异常，排查是否缺少系统库（原生模式下可能需要额外系统依赖）

6. 验证镜像与K8s节点的兼容性 #

确保镜像基础镜像和K8s节点操作系统兼容：

• 官方Dockerfile可能使用ubi8、alpine等基础镜像，检查K8s节点OS是否与基础镜像匹配，比如alpine镜像在部分节点可能存在libc兼容性问题
• 尝试切换基础镜像（比如从alpine换成ubi8），重新构建后部署测试

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