WebSphere 9部署含@WebService的EJB EAR后Web服务无法访问排查

算力阿峰

2026-5-15

作为经常和WebSphere打交道的开发者，我太懂这种跨容器部署的坑了——WebSphere的JAX-WS EJB服务暴露逻辑和WebLogic、GlassFish确实有不少差异，咱们一步步来排查解决：

前置条件确认

首先得确保你的WebSphere环境和应用包满足这些要求：

启用JAX-WS特性：WebSphere 9默认可能没完全开启JAX-WS支持，你需要登录管理控制台，进入服务器 -> 应用服务器 -> [你的目标服务器] -> 服务器基础结构 -> Java和进程管理 -> 进程定义 -> Java虚拟机 -> 定制属性，检查是否存在com.ibm.websphere.webservices.jaxws.enable=true这个属性；或者直接去服务器的特性页面，确认勾选了jaxws-2.2或jaxws-2.3（对应你的Java EE版本）。
规范的EJB注解与配置：确保你的EJB类上的@WebService注解明确指定了serviceName和portName，比如：

@WebService(serviceName = "MyWebService", portName = "MyWebServicePort")
@Stateless
public class MyWebServiceImpl implements MyWebService {
    // 业务方法实现
}

同时，EJB JAR里最好包含ejb-jar.xml（哪怕是标注驱动的空配置），WebSphere对XML配置的依赖度比其他容器高一些。

正确的EAR结构：EAR的META-INF/application.xml必须正确声明EJB模块，比如：

<application xmlns="http://java.sun.com/xml/ns/javaee" version="6">
    <display-name>my-app-display-name</display-name>
    <module>
        <ejb>my-ejb-service.jar</ejb>
    </module>
</application>

EJB JAR要放在EAR根目录或指定的模块路径下，不能随意嵌套。

部署后的排查步骤

部署成功但看不到服务、访问404，大概率是路径找错或者初始化有隐藏错误：

查看服务器日志：去WebSphere的日志目录（[WAS安装路径]/profiles/[你的概要]/logs/[服务器名]），打开SystemOut.log和SystemErr.log，搜索你的服务类名或WebService关键词，看是否有初始化失败的报错（比如类加载冲突、注解解析异常）。
找对管理控制台的服务入口：WebSphere里EJB类型的JAX-WS服务不在顶层的“Web服务”菜单，正确路径是应用程序 -> 企业应用程序 -> [你的EAR应用] -> 模块 -> [对应EJB模块] -> Web服务，在这里你能看到已注册的服务详情，包括官方给出的WSDL地址。
纠正WSDL访问URL格式：WebSphere的EJB Web服务URL和其他容器不一样，正确格式是：
```
http://localhost:[WC_defaulthost端口]/[EJB模块名称]/[serviceName]?wsdl
```
比如你的EJB模块叫my-ejb-service.jar，serviceName是MyWebService，端口是默认的9080，那URL就是http://localhost:9080/my-ejb-service/MyWebService?wsdl。另外，你之前用的8880大概率不是应用服务端口，去服务器 -> 应用服务器 -> [你的服务器] -> 端口里查看WC_defaulthost对应的端口才是正确的HTTP服务端口。

正确的Web服务测试方法

先通过管理控制台获取官方WSDL地址：按照上面的路径找到服务后，直接复制控制台显示的WSDL URL到浏览器访问，确认能正常返回XML内容。
SOAPUI测试时直接导入控制台给出的WSDL：不要自己拼接地址，避免格式错误，导入后生成请求再测试。
用wsadmin命令行验证服务：如果控制台看不到服务，启动[WAS安装路径]/bin/wsadmin.sh（Windows用.bat），执行命令：
```
AdminTask.listWebServices('[-applicationName my-app-display-name]')
```
这个命令会列出应用下所有Web服务的详细信息，包括正确的访问端点。

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