使用Jenkins/WAS脚本部署EAR失败，控制台部署正常（dd_in_ear_load_EXC_）

安全阿岳

2026-6-29

排查方向整理

以下是针对该问题的具体排查点：

执行权限差异：检查Jenkins运行用户或脚本执行用户的权限，确认该用户能读取EAR文件所在目录，且拥有WAS临时目录（如${WAS_HOME}/temp、${WAS_HOME}/wstemp）的读写权限。控制台部署使用的服务器进程用户权限通常更高，脚本执行用户可能存在权限不足，导致无法解压或读取EAR内部文件。
EAR文件完整性校验：对比控制台使用的本地EAR与Jenkins构建/传输后的EAR文件MD5值，确认文件未在构建、拷贝或传输过程中损坏。部分场景下，Jenkins打包插件可能意外修改EAR内部结构，导致部署描述符无法正常加载。
部署脚本参数匹配：核对AdminApp.update脚本的参数与控制台部署时的配置选项是否一致。例如控制台部署时勾选的「生成默认绑定」「覆盖现有绑定」「部署EJB」等选项，需要在脚本中通过对应参数（如-deployejb true、-defaultbinding.ejbjndi true）明确指定，参数缺失可能导致描述符加载逻辑异常。
WAS专属部署描述符检查：除标准XML文件外，重点排查EAR内的WAS特有描述符，包括ibm-web-bnd.xml、ibm-ejb-jar-bnd.xml、ibm-application-bnd.xml等。这类文件的语法错误或版本不兼容问题，可能在控制台部署时被WAS自动修复，但脚本部署会严格校验导致加载失败。
清理WAS临时缓存：手动清理WAS的temp和wstemp目录下的残留缓存文件，避免旧部署残留的损坏文件干扰新部署流程。控制台部署通常会自动隔离临时文件，而脚本部署可能复用缓存路径。
客户端版本兼容性：确认Jenkins环境中使用的WAS管理客户端（wsadmin相关jar包）版本与目标WAS服务器版本完全一致。版本不匹配会导致部署协议或描述符解析逻辑出现兼容性问题。
环境变量与JDK一致性：检查脚本执行环境的JAVA_HOME、CLASSPATH是否与WAS服务器要求一致。使用非WAS兼容的JDK版本，可能导致XML部署描述符解析失败。