WildFly部署.war文件出现DeploymentUnitProcessingException错误如何解决
WildFly部署war包STRUCTURE阶段错误解决方案
完整报错信息如下:
Failed to process phase STRUCTURE of deployment
Caused by: org.jboss.as.server.deployment.DeploymentUnitProcessingException: Failed to get manifest for deployment "C:/ProgramFiles (x86)/wildfly-19.1.0.Final/bin/content/.war/WEB-INF/lib/xmlbeans-3.1.0.jar"
Caused by: java.util.zip.ZipException: Invalid LOC header (bad signature)
错误根因
该报错核心是xmlbeans-3.1.0.jar包出现了zip结构损坏,WildFly在部署阶段读取该jar包的MANIFEST清单文件时无法识别jar的压缩结构,直接中断部署流程。
排查步骤
- 校验部署目录下的目标jar包完整性:进入WildFly部署解压后的路径
C:/ProgramFiles (x86)/wildfly-19.1.0.Final/bin/content/<FILENAME>.war/WEB-INF/lib,执行校验命令jar -tf xmlbeans-3.1.0.jar,如果返回报错即可确认该jar包已损坏。 - 校验原始war包完整性:对本地未上传部署的原始war包执行命令
jar -tf <你的项目包名>.war,确认打包阶段是否就已经出现jar损坏问题。 - 校验本地依赖仓库的xmlbeans包:如果项目通过Maven/Gradle等工具管理依赖,找到本地依赖仓库中
org/apache/xmlbeans/3.1.0的存储目录,执行jar -tf xmlbeans-3.1.0.jar,确认是否是本地依赖缓存本身损坏。
解决方案
- 本地依赖缓存损坏:删除本地仓库中
org/apache/xmlbeans下的3.1.0版本目录,重新执行构建命令拉取依赖,重新打包war包后再部署。 - WildFly部署解压异常:先停止WildFly服务,删除
standalone/tmp、standalone/data、standalone/deployments目录下对应war包的所有残留文件,重新上传完整的war包后启动服务即可。 - 构建配置异常:如果多次打包后war包内的jar依然损坏,调整构建工具的压缩配置,降低打包压缩等级,避免高压缩率导致的zip结构异常。
内容的提问来源于stack exchange,提问作者Arunita Mehta
相关产品推荐
相关产品推荐

