无法将Jenkins连接至IBM WebSphere 8.5求助排查

问题背景 #

• 环境配置：Java 8、Jenkins 2.346.3、WebSphere Deployer插件1.6.1
• 已完成操作：将com.ibm.ws.admin.client_8.5.jar、com.ibm.ws.orb_*.jar、com.ibm.ws.webservices.thinclient_8.5.jar复制到/websphere-deployer/WEB-INF/lib目录
• 故障现象：本地连接WebSphere（SOAP端口8880）时，点击「测试连接」报错，已尝试插件文档所有配置仍无法连通
• WebSphere配置截图：

排查步骤 #

1. 端口连通性验证 #

• 在Jenkins服务器执行命令telnet localhost 8880或nc -zv localhost 8880，确认SOAP端口是否开放且可访问
• 若存在网络隔离（即使本地连接也需确认），检查防火墙、安全组是否放行8880端口

2. JAR包版本与完整性检查 #

• 确认复制的JAR包与WebSphere服务器版本完全匹配（需为8.5.x对应版本，com.ibm.ws.orb_*.jar需替换通配符为具体版本号，不能保留*）
• 检查/websphere-deployer/WEB-INF/lib目录下是否存在重复或冲突的JAR包，比如不同版本的wsadmin相关依赖

3. WebSphere SOAP连接器配置校验 #

• 登录WebSphere控制台，确认：
  • SOAP连接器已启用（路径：服务器 -> 服务器类型 -> WebSphere应用服务器 -> 目标服务器 -> 端口，查看SOAP_CONNECTOR_ADDRESS状态）
  • 连接器绑定地址不是仅localhost（若Jenkins与WebSphere不在同一进程，需绑定到可访问IP，如0.0.0.0）
• 查看WebSphere的SystemOut.log，搜索SOAP关键字，确认连接器启动正常，无绑定失败日志

4. Jenkins连接参数与权限检查 #

• 确认Jenkins运行用户对/websphere-deployer/WEB-INF/lib目录及JAR包拥有读权限
• 检查Jenkins全局配置中WebSphere的连接参数：
  • 主机名填写localhost或127.0.0.1，避免主机名解析问题
  • 用户名/密码为WebSphere管理员账户，且具备服务器管理员角色权限
  • 确认未错误勾选SSL选项（若未配置SSL连接，需取消SSL勾选）

5. 日志定位具体错误 #

• 查看Jenkins日志（默认路径/var/log/jenkins/jenkins.log或Jenkins控制台系统日志），搜索SOAPException、Connection refused等关键字，定位报错根源
• 查看WebSphere的SystemErr.log，确认是否存在认证失败、连接拒绝类日志

内容的提问来源于stack exchange，提问作者Bukhari Syed