迁移至JBoss EAP 7.0.8后CSS/JS响应头MIME类型异常求助

你遇到的这个问题在JBoss EAP 7.x迁移场景里挺常见——静态资源的MIME类型被错误设为application/json，导致浏览器无法正确解析CSS和JS，直接影响页面样式和交互功能。结合JSF 2.2的特性，我整理了几个亲测有效的排查和解决方向：

1. 检查web.xml的静态资源映射与MIME配置 #

首先排查应用自身的web.xml，很可能是自定义的Servlet映射覆盖了默认的MIME处理逻辑：

• 如果存在类似下面的错误映射，会把CSS/JS路由到JSON处理Servlet，直接导致Content-Type异常：

<servlet-mapping>
    <servlet-name>JsonProcessingServlet</servlet-name>
    <url-pattern>*.css</url-pattern>
    <url-pattern>*.js</url-pattern>
</servlet-mapping>

修复方式：移除这类错误映射，同时显式添加正确的MIME映射规则：

<mime-mapping>
    <extension>css</extension>
    <mime-type>text/css</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>js</extension>
    <mime-type>text/javascript</mime-type>
</mime-mapping>

2. 修正JBoss服务器的全局MIME配置 #

JBoss EAP的Undertow容器默认MIME配置可能被修改过，需要检查服务器配置文件（比如standalone/configuration/standalone.xml或domain/configuration/domain.xml）：
定位到undertow子系统下的mime-types节点，确保包含CSS和JS的正确映射：

<subsystem xmlns="urn:jboss:domain:undertow:4.0">
    <!-- 其他配置省略 -->
    <mime-types>
        <mime-type name="text/css" extension="css"/>
        <mime-type name="text/javascript" extension="js"/>
        <!-- 保留其他默认MIME类型 -->
    </mime-types>
</subsystem>

如果缺失上述条目，手动添加后重启JBoss服务即可。

3. 排查自定义JSF ResourceHandler的问题 #

因为你使用的是JSF 2.2，若自定义了ResourceHandler做资源压缩、版本管理等操作，可能在处理响应时错误设置了Content-Type：
检查你的自定义ResourceHandler实现，确保针对CSS/JS资源设置正确的响应头：

@Override
public void handleResourceRequest(FacesContext context) throws IOException {
    Resource resource = super.createResource(context.getExternalContext().getRequestServletPath());
    if (resource != null) {
        String requestPath = resource.getRequestPath();
        String contentType;
        if (requestPath.endsWith(".css")) {
            contentType = "text/css";
        } else if (requestPath.endsWith(".js")) {
            contentType = "text/javascript";
        } else {
            contentType = resource.getContentType();
        }
        context.getExternalContext().setResponseContentType(contentType);
        // 其他资源处理逻辑
    }
}

4. 检查过滤器链是否篡改了响应头 #

应用中的某些过滤器（比如权限校验、日志采集过滤器）可能无意中修改了静态资源的Content-Type。比如过滤器里如果写了response.setContentType("application/json");且未做请求路径判断，就会覆盖CSS/JS的正确MIME类型。

修复方式：修改过滤器逻辑，仅对需要处理的JSON请求设置Content-Type，跳过*.css和*.js路径的请求。

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