Spring Boot混淆JAR本地正常，Azure Pipeline部署后502故障求助

可能的故障原因 #

1. ProGuard混淆过度破坏Spring Boot核心逻辑
   本地与CI环境的ProGuard配置可能存在差异，CI环境的混淆规则可能误将@RestController、@RequestMapping等Spring核心注解类/方法名混淆，导致Spring无法识别并映射端点。另外，若本地构建时未激活ProGuard（仅CI环境激活），也会出现本地正常但部署后异常的情况。

2. Docker镜像构建的环境/命令差异
   CI环境构建的JAR与本地JAR可能不一致，比如Maven依赖版本不同、ProGuard执行参数差异；或Dockerfile中未正确暴露端口、启动命令指定了错误的端口/JVM参数，导致应用监听端口与Azure配置不匹配。

3. Azure部署的网络/端口映射错误
   Azure App Service或容器服务的端口配置（如WEBSITES_PORT）与应用实际监听的端口不匹配，或安全组、网络规则拦截了外部请求，导致流量无法到达应用。

4. 应用静默初始化失败
   应用进程显示已启动，但核心Bean（如数据库连接、配置加载）初始化失败，导致端点无法提供服务。本地环境配置齐全，而CI/生产环境缺少必要的环境变量或配置文件，引发静默异常。

排查步骤 #

1. 定位构建环节问题 #

• 下载CI Pipeline构建的JAR包，本地运行测试：若本地运行也出现端点不可用，说明问题出在构建阶段（ProGuard或Maven配置）。
• 反编译CI构建的JAR，检查关键类/注解：用JD-GUI等工具查看@RestController类、@RequestMapping注解是否被混淆，类名/方法名是否变为无意义的标识符。
• 核对ProGuard规则：确保CI与本地的规则一致，必须保留Spring核心组件，示例规则如下：

  -keep @org.springframework.web.bind.annotation.RestController class *
  -keep @org.springframework.web.bind.annotation.RequestMapping class *
  -keepclassmembers class * {
      @org.springframework.web.bind.annotation.* <methods>;
  }
  -keep class com.yourpackage.YourApplication {
      public static void main(java.lang.String[]);
  }
  

2. 验证Docker镜像有效性 #

• 查看Dockerfile：确认包含EXPOSE [应用端口]，启动命令（如java -jar your-app.jar）正确，若指定了server.port参数需与Azure配置一致。
• 本地运行CI构建的镜像：执行docker run -p 8080:8080 [镜像ID]，测试端点是否可用，排除镜像本身的问题。
• 查看容器日志：执行docker logs [容器ID]，检查是否有端口监听日志（如Tomcat started on port(s): 8080 (http)）或初始化异常。

3. 检查Azure部署配置 #

• 确认端口映射：在Azure Portal中查看应用服务的“配置”->“常规设置”，确保WEBSITES_PORT与应用监听端口一致；容器实例需检查端口映射规则。
• 查看Azure日志流：进入应用服务的“监控”->“日志流”，检查是否有请求到达但未响应，或应用启动时的隐藏异常。
• 测试容器内部连通性：通过Azure CLI或远程登录容器，执行curl localhost:[端口]/your-endpoint，确认应用在容器内部是否能正常响应。

4. 临时禁用ProGuard验证 #

在CI Pipeline中临时注释ProGuard插件配置，构建未混淆的JAR并部署。若问题消失，可确定是ProGuard规则问题，需逐步调整规则，保留所有与Spring Boot运行、端点映射相关的类、注解和方法。

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