如何配置Undertow为WildFly-15 Web服务设置带UTF-8的Content-Type响应头？

问题背景 #

你遇到的情况确实棘手：客户端请求时从不指定Content-Type的charset参数，导致Wildfly的Undertow组件默认返回charset=ISO-8859-1，但你的响应实际是UTF-8编码，最终触发了IBM Websphere的XML解析异常。更麻烦的是客户端无法修改，只能从服务端入手解决。

原因分析 #

正如你提到的，Undertow的extractCharset方法在请求头没有charset参数时，会默认返回ISO_8859_1。之前你尝试的普通过滤器无效，是因为Web服务栈（比如JAX-WS）在处理响应时会重新生成Content-Type头，优先级高于普通过滤器的设置，导致你的配置被覆盖。

解决方案 #

方案1：通过Wildfly Undertow配置强制全局字符集（推荐） #

这种方式不需要修改代码，直接通过配置让所有响应自动带上charset=UTF-8：

1. 打开Wildfly的配置文件（standalone.xml或domain.xml），找到<subsystem xmlns="urn:jboss:domain:undertow:7.0">节点（Wildfly 15对应Undertow 2.x，命名空间为该值）。
2. 在<server>节点下的<http-listener>中添加default-charset="UTF-8"属性：

<http-listener name="default" socket-binding="http" redirect-socket="https" default-charset="UTF-8"/>

3. 同时在<servlet-container>节点中配置默认字符集，确保Servlet/Web服务层面也生效：

<servlet-container name="default">
    <jsp-config/>
    <websockets/>
    <default-charset value="UTF-8"/>
</servlet-container>

4. 重启Wildfly即可生效。

如果全局配置不适合你的场景，也可以针对单个应用配置：在你的WAR包的WEB-INF/jboss-web.xml中添加如下内容：

<jboss-web>
    <default-charset>UTF-8</default-charset>
</jboss-web>

方案2：编程方式强制设置响应头（针对单个Web服务） #

如果需要更精细的控制，或者全局配置不符合业务需求，可以通过代码实现：

方式A：JAX-WS端点直接设置响应头

如果你的Web服务基于JAX-WS，可以在端点方法中通过WebServiceContext获取HTTP响应对象，手动修改Content-Type：

import javax.annotation.Resource;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.servlet.http.HttpServletResponse;
import javax.xml.ws.WebServiceContext;
import javax.xml.ws.handler.MessageContext;

@WebService
public class YourWebService {

    @Resource
    private WebServiceContext webServiceContext;

    @WebMethod
    public String yourServiceMethod(String request) {
        // 获取HTTP响应对象
        MessageContext messageContext = webServiceContext.getMessageContext();
        HttpServletResponse response = (HttpServletResponse) messageContext.get(MessageContext.SERVLET_RESPONSE);
        
        // 强制设置Content-Type为UTF-8编码
        response.setContentType("text/xml;charset=UTF-8");
        
        // 处理业务逻辑并返回响应
        return "你的UTF-8编码XML响应内容";
    }
}

方式B：使用JAX-WS SOAPHandler拦截所有响应

如果有多个Web服务方法，写个拦截器更高效：

1. 创建拦截器类：

import javax.xml.namespace.QName;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;
import java.util.Set;

public class CharsetHandler implements SOAPHandler<SOAPMessageContext> {

    @Override
    public Set<QName> getHeaders() {
        return null;
    }

    @Override
    public boolean handleMessage(SOAPMessageContext context) {
        // 判断是否为响应消息
        Boolean isResponse = (Boolean) context.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);
        if (isResponse) {
            // 设置Content-Type头
            context.put(MessageContext.HTTP_RESPONSE_HEADERS, 
                        java.util.Collections.singletonMap("Content-Type", 
                        java.util.Collections.singletonList("text/xml;charset=UTF-8")));
            context.setScope(MessageContext.HTTP_RESPONSE_HEADERS, MessageContext.Scope.APPLICATION);
        }
        return true;
    }

    @Override
    public boolean handleFault(SOAPMessageContext context) {
        return true;
    }

    @Override
    public void close(MessageContext context) {
        // 清理资源
    }
}

2. 在Web服务类上添加注解指定拦截器：

@WebService
@HandlerChain(file = "handler-chain.xml")
public class YourWebService {
    // 服务方法...
}

3. 在WEB-INF下创建handler-chain.xml配置文件：

<?xml version="1.0" encoding="UTF-8"?>
<handler-chains xmlns="http://java.sun.com/xml/ns/javaee">
  <handler-chain>
    <handler>
      <handler-name>CharsetHandler</handler-name>
      <handler-class>com.yourpackage.CharsetHandler</handler-class>
    </handler>
  </handler-chain>
</handler-chains>

方式C：Spring WS拦截器（如果使用Spring Web Services）

如果你的服务基于Spring WS，可以实现EndpointInterceptor来修改响应头：

import org.springframework.ws.context.MessageContext;
import org.springframework.ws.server.EndpointInterceptor;
import org.springframework.ws.transport.http.HttpServletConnection;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

public class CharsetInterceptor implements EndpointInterceptor {

    @Override
    public boolean handleRequest(MessageContext messageContext, Object endpoint) throws Exception {
        return true;
    }

    @Override
    public boolean handleResponse(MessageContext messageContext, Object endpoint) throws Exception {
        HttpServletConnection connection = (HttpServletConnection) messageContext.getResponse();
        HttpServletResponse response = connection.getHttpServletResponse();
        response.setContentType("text/xml;charset=UTF-8");
        return true;
    }

    @Override
    public boolean handleFault(MessageContext messageContext, Object endpoint) throws Exception {
        return true;
    }

    @Override
    public void afterCompletion(MessageContext messageContext, Object endpoint, Exception ex) throws Exception {
        // 清理资源
    }
}

然后在Spring配置文件中注册拦截器：

<bean id="charsetInterceptor" class="com.yourpackage.CharsetInterceptor"/>

<sws:interceptors>
    <ref bean="charsetInterceptor"/>
</sws:interceptors>

验证 #

配置或编码完成后重启服务，再次请求查看响应头，应该会看到Content-Type=text/xml;charset=UTF-8，这样Websphere客户端就能正确解析UTF-8编码的XML响应了。

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