如何在AJP代理下让WildFly/JBoss返回正确的上下文路径？

当你通过Apache的AJP反向代理将域名根路径映射到WildFly/JBoss中带独立context-root的Web应用时，应用仍会返回原始的上下文路径（如/webapp1），导致生成的URL包含不必要的前缀。以下是几种可行的解决方法：

方法一：通过Apache传递转发前缀头，让WildFly识别实际路径 #

在Apache的VirtualHost配置中添加请求头，告知WildFly当前请求的实际前缀为空，同时开启WildFly的转发头处理功能：

1. 修改Apache的AJP代理配置 #

<VirtualHost webapp1.example.com:80>
    ProxyPass / ajp://123.123.123.123:8009/webapp1/
    ProxyPassReverse / ajp://123.123.123.123:8009/webapp1/
    # 传递实际路径前缀为空的请求头
    RequestHeader set X-Forwarded-Prefix ""
</VirtualHost>

<VirtualHost webapp2.example.com:80>
    ProxyPass / ajp://123.123.123.123:8009/webapp2/
    ProxyPassReverse / ajp://123.123.123.123:8009/webapp2/
    RequestHeader set X-Forwarded-Prefix ""
</VirtualHost>

2. 配置WildFly的Undertow子系统处理转发头 #

编辑WildFly的standalone.xml或domain.xml，在Undertow配置中添加转发头过滤器：

<subsystem xmlns="urn:jboss:domain:undertow:12.0" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
    <server name="default-server">
        <ajp-listener name="ajp" socket-binding="ajp" />
        <host name="default-host" alias="localhost">
            <location name="/" handler="welcome-content" />
            <!-- 引用转发头过滤器 -->
            <filter-ref name="forwarded" />
        </host>
    </server>
    <filters>
        <!-- 定义转发头处理过滤器 -->
        <filter name="forwarded" class-name="io.undertow.server.handlers.ProxyPeerAddressHandler" module="io.undertow.core">
            <param name="proxy-address-forwarding" value="true" />
            <param name="forwarded-prefix-header" value="X-Forwarded-Prefix" />
            <!-- 可选：同时处理其他转发头，如IP、主机、协议 -->
            <param name="forwarded-header" value="X-Forwarded-For" />
            <param name="forwarded-host-header" value="X-Forwarded-Host" />
            <param name="forwarded-proto-header" value="X-Forwarded-Proto" />
        </filter>
    </filters>
</subsystem>

重启WildFly后，HttpServletRequest.getContextPath()会返回空字符串，应用生成的URL也不再包含原始上下文路径前缀。

方法二：为每个应用配置独立虚拟主机并设为根路径 #

这种方法让每个Web应用在对应域名下直接以根路径运行，不需要在Apache代理中添加上下文路径前缀：

1. 在WildFly中添加虚拟主机 #

编辑standalone.xml，为每个应用添加专属虚拟主机：

<server name="default-server">
    <ajp-listener name="ajp" socket-binding="ajp" />
    <!-- webapp1的虚拟主机 -->
    <host name="webapp1-host" alias="webapp1.example.com">
        <location name="/" handler="welcome-content" />
        <filter-ref name="forwarded" />
    </host>
    <!-- webapp2的虚拟主机 -->
    <host name="webapp2-host" alias="webapp2.example.com">
        <location name="/" handler="welcome-content" />
        <filter-ref name="forwarded" />
    </host>
</server>

2. 修改应用的jboss-web.xml #

在每个应用的WEB-INF/jboss-web.xml中设置上下文路径为根，并绑定到对应虚拟主机：

<!-- webapp1的jboss-web.xml -->
<jboss-web>
    <context-root>/</context-root>
    <virtual-host>webapp1-host</virtual-host>
</jboss-web>

<!-- webapp2的jboss-web.xml -->
<jboss-web>
    <context-root>/</context-root>
    <virtual-host>webapp2-host</virtual-host>
</jboss-web>

3. 简化Apache代理配置 #

<VirtualHost webapp1.example.com:80>
    ProxyPass / ajp://123.123.123.123:8009/
    ProxyPassReverse / ajp://123.123.123.123:8009/
</VirtualHost>

<VirtualHost webapp2.example.com:80>
    ProxyPass / ajp://123.123.123.123:8009/
    ProxyPassReverse / ajp://123.123.123.123:8009/
</VirtualHost>

方法三：使用Undertow重写规则移除上下文路径前缀 #

如果无法修改应用配置或Apache代理，可通过WildFly的Undertow重写规则，将请求路径中的上下文前缀移除：

编辑standalone.xml的Undertow子系统，添加重写过滤器：

<subsystem xmlns="urn:jboss:domain:undertow:12.0">
    <server name="default-server">
        <ajp-listener name="ajp" socket-binding="ajp" />
        <host name="default-host" alias="localhost,webapp1.example.com,webapp2.example.com">
            <location name="/" handler="welcome-content" />
            <filter-ref name="context-rewrite" />
        </host>
    </server>
    <filters>
        <filter name="context-rewrite" class-name="io.undertow.server.handlers.RewriteHandler" module="io.undertow.core">
            <param name="rewrite-rules">
                # 针对webapp1域名，移除/webapp1前缀
                ^/webapp1/(.*)$ /$1 [L]
                # 针对webapp2域名，移除/webapp2前缀
                ^/webapp2/(.*)$ /$1 [L]
            </param>
        </filter>
    </filters>
</subsystem>

这种方法适合临时场景，但需要注意重写规则可能会影响部分请求路径的匹配，建议结合转发头处理一起使用。

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