Wildfly使用Endpoint.publish发布多WebService端点无法访问问题

核心结论 #

你当前的用法无法在Wildfly上正常生效，报错不是业务代码逻辑问题，是API适配和容器机制的问题。

问题根因 #

• JDK自带的Endpoint.publish()是JAX-WS参考实现提供的轻量独立发布能力，本质是方法内部会启动一个内置的微型HTTP服务器监听指定端口，直接处理WS请求，和Java EE应用服务器的Web容器、WS子系统完全隔离。
• Wildfly启动时已经由Undertow容器抢占了8080端口的全部HTTP监听权，你调用Endpoint.publish()传入0.0.0.0:8080地址时，内置HTTP服务根本无法绑定端口，也不会把服务端点注册到Wildfly的请求路由表中。所有发往/ws/export1、/ws/export2的请求最终会落到Wildfly的默认Servlet上，默认Servlet不支持WS的POST请求、也不会生成返回WSDL，就会出现你看到的错误。

可行实现方案 #

你要从配置文件动态读取URL、不使用Wildfly默认注解式固定路径发布的需求完全可以实现，不需要硬套JDK自带的Endpoint.publish()方法，推荐两种稳定方案：

• 方案1：使用Wildfly内置集成的Apache CXF编程式API发布（兼容性最好，推荐生产用）
  在应用启动阶段（比如通过ServletContextListener监听上下文初始化事件，或者CDI监听@Initialized(ApplicationScoped.class)事件），读取配置文件中的自定义路径，通过CXF的工厂类创建服务端点即可，发布的服务会自动注册到Wildfly的Web路由中，WSDL访问、SOAP请求调用都和默认注解发布的服务完全一致。
  核心示例代码：

  // 从配置文件读取自定义路径，比如读到/ws/export1
  String wsPath = config.getProperty("ws.export1.path");
  JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
  factory.setAddress(wsPath);
  factory.setServiceBean(new ImplementationClass());
  factory.create();
  

  注意配置路径时不需要写IP和端口，只写应用上下文后的相对路径即可，监听地址、端口、线程池都复用Wildfly的全局配置，符合容器规范。
• 方案2：使用容器托管的Endpoint实例发布
  如果你一定要用标准JAX-WS的EndpointAPI，不要直接调用JDK自带实现的publish方法，要通过JNDI查找Wildfly提供的容器托管Endpoint实现类，发布时传入相对路径而非全量URL。该方案在不同Wildfly版本中API差异较大，不推荐优先使用。

避坑提醒 #

不要尝试修改Endpoint.publish()的端口为非8080端口（比如8090）来绕开端口冲突，这种方式启动的WebService完全脱离Wildfly的容器管控：不走全局安全配置、不受容器线程池管理、无法接入容器监控链路，生产环境运行会存在大量稳定性和安全隐患。如果确实要使用独立端口的内置发布模式，直接在Java SE环境运行即可，不需要部署到Wildfly容器中。

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