You need to enable JavaScript to run this app. Spring Boot应用部署Azure App Service失败:插件提示找不到可执行jar包
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot应用部署Azure App Service失败:插件提示找不到可执行jar包

问题核心根源
  • 你所使用的com.microsoft.azure:azure-webapp-maven-plugin:1.8.0为已停止维护的老旧版本,存在多个已确认的文件扫描逻辑缺陷,是触发该报错的核心原因:
    • Windows环境下路径反斜杠转义解析错误,导致对target目录下*.jar文件的通配匹配失效,即便jar包实际存在也无法被识别
    • 对Spring Boot生成的fat jar的结构校验逻辑存在Bug,部分场景下会将合规的可执行jar判定为不可部署文件,且不给出明确的校验提示
    • 跨执行阶段的状态冲突:手动串联执行mvn clean package azure-webapp:deploy时,老版本插件会在扫描部署文件前提前清理临时构建目录,部分场景下会误操作导致刚生成的jar包无法被扫描到
  • 配置适配偏差:执行mvn azure-webapp:config自动生成插件配置时,1.8.0版本会默认沿用WAR包项目的扫描规则,未针对Spring Boot fat jar场景做适配,导致扫描规则和实际构建产物不匹配。
需补充的操作与配置调整
  • 替换pom.xml中原有的1.8.0版本插件依赖,升级为当前稳定维护的3.x版本,从根源上规避老旧版本的逻辑Bug
  • 在插件配置块中显式指定部署文件规则,不依赖插件的自动扫描逻辑:
    <deployment>
      <resources>
        <resource>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
    
  • 拆分命令执行步骤,避免跨阶段执行冲突:先单独执行mvn clean package,确认target目录下的jar包完整、可正常读取后,再单独执行mvn azure-webapp:deploy完成部署推送
  • 排查本地路径合规性:如果settings.xml配置的Maven本地仓库、项目存放路径包含中文、空格或特殊字符,需调整为纯英文无特殊字符的路径,避免路径解析错误
  • 校验jar包完整性:确认target目录下的jar包是构建流程完整生成的fat jar,没有因构建中断、权限拦截生成大小为0的残缺文件

升级插件版本后可直接通过az login获取的临时凭证完成认证,无需额外在settings.xml中配置服务主体的明文密码,减少不必要的配置环节。

内容的提问来源于stack exchange,提问作者Shabs

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.21 05:45:04