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包无法被扫描到
- Windows环境下路径反斜杠转义解析错误,导致对
- 配置适配偏差:执行
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
相关产品推荐
相关产品推荐

