Wildfly 23部署JAX-WS服务后访问WSDL遇403/404问题求助

1. 核对SEI与实现类的注解配置 #

Wildfly 23采用Apache CXF作为JAX-WS实现，与Sun Metro的注解细节要求有差异，需确保：

• 服务端点接口（SEI）标注@WebService并指定targetNamespace（需与预期WSDL的命名空间一致）
• 实现类标注@WebService(endpointInterface = "你的SEI全限定类名")，不要重复定义targetNamespace，避免冲突
• 方法上的@WebMethod、@WebParam等注解参数配置正确

示例代码：

// SEI
@WebService(targetNamespace = "http://yourdomain.com/employee")
public interface EmployeeService {
    @WebMethod
    Employee getEmployee(@WebParam(name = "empId") Long id);
}

// 实现类
@WebService(endpointInterface = "com.yourdomain.EmployeeService")
public class EmployeeServiceImpl implements EmployeeService {
    @Override
    public Employee getEmployee(Long id) {
        // 业务逻辑实现
        return new Employee(id, "Test Name");
    }
}

2. 完善web.xml的CXF Servlet映射 #

Wildfly需要通过CXF Servlet暴露JAX-WS服务，需在web.xml中添加以下配置：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="4.0">
    <servlet>
        <servlet-name>CXFServlet</servlet-name>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>CXFServlet</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>
</web-app>

配置完成后，WSDL的访问路径应为：http://localhost:8080/employee-service/services/EmployeeService?wsdl（路径规则：上下文根 + Servlet映射路径 + 服务类名）

3. 开启CXF调试日志定位问题 #

默认日志级别可能无法显示服务注册细节，可修改Wildfly的standalone/configuration/standalone.xml，添加CXF的DEBUG日志：

<logger category="org.apache.cxf">
    <level name="DEBUG"/>
</logger>

重启Wildfly后查看standalone/log/server.log，日志会显示服务是否被成功注册、端点路径等关键信息，快速定位配置遗漏点。

4. 检查依赖冲突与类加载问题 #

若WAR包中包含Metro或其他JAX-WS实现的依赖，会与Wildfly自带的CXF冲突，导致服务无法加载。Maven项目需将JAX-WS相关依赖设为provided：

<dependency>
    <groupId>javax.xml.ws</groupId>
    <artifactId>jaxws-api</artifactId>
    <version>2.3.1</version>
    <scope>provided</scope>
</dependency>

避免打包Wildfly已提供的API或实现类，防止类加载冲突。

5. 通过管理控制台验证部署状态 #

访问Wildfly管理控制台（默认地址http://localhost:9990），查看已部署的WAR包：

• 确认上下文根/employee-service已正确注册
• 检查CXF Servlet是否被成功加载并映射到指定路径

6. 兜底方案：手动发布端点 #

若上述配置均无效，可在实现类中添加@PostConstruct方法手动发布端点：

@WebService(endpointInterface = "com.yourdomain.EmployeeService")
public class EmployeeServiceImpl implements EmployeeService {
    @PostConstruct
    public void publishEndpoint() {
        String endpointUrl = "http://localhost:8080/employee-service/EmployeeService";
        Endpoint.publish(endpointUrl, this);
    }

    @Override
    public Employee getEmployee(Long id) {
        // 业务逻辑实现
        return new Employee(id, "Test Name");
    }
}

该方式无需依赖CXF Servlet，直接发布端点，需确保URL中的端口、上下文根与Wildfly配置一致。

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