JBoss应用中getContextPath()跨环境表现异常的技术求助

问题背景 #

你遇到的情况很典型：在Apache Tomcat 7做负载均衡、JBoss 6.2作为应用服务器的架构里，request.getContextPath()在测试环境能正确返回负载均衡地址（https://esam-test.abc.com/emea），但开发环境却返回了应用服务器的直接地址（https://c1234.abc.com/emea），导致页面资源URL不符合预期。

核心原因 #

这种不一致通常是因为负载均衡服务器没有正确传递原始请求的主机头信息，或者JBoss应用服务器未配置为使用负载均衡传递的外部地址信息。当请求经过负载均衡时，如果LB没把原始的Host头、X-Forwarded-For、X-Forwarded-Proto等头部传给JBoss，JBoss就会用自身的服务器地址生成上下文路径的完整URL。测试环境应该已经配置了这些头部传递，而开发环境漏掉了相关配置，才会出现差异。

具体解决方案 #

以下是分步骤的修复方法：

1. 配置Apache Tomcat负载均衡传递必要HTTP头

在Apache Tomcat的负载均衡配置（比如server.xml里的Connector或mod_proxy相关配置）中，添加以下转发头部：

<!-- 在Connector或Proxy配置块中添加 -->
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https"
RequestHeader set X-Forwarded-Host "esam-dev.abc.com"

• ProxyPreserveHost On：让Tomcat保留原始请求的Host头，而非替换成后端JBoss的地址。
• X-Forwarded-Proto：告知JBoss原始请求使用的协议（此处为HTTPS）。
• X-Forwarded-Host：明确指定负载均衡的外部域名，确保JBoss生成URL时采用该地址。

2. 配置JBoss 6.2识别转发头部

JBoss需要信任这些转发头部，并以此构建正确的外部URL。修改JBoss的standalone.xml（或domain.xml，取决于部署模式）：
在<subsystem xmlns="urn:jboss:domain:web:1.4" ...>节点下，添加proxy-address-forwarding="true"，并配置虚拟服务器别名：

<subsystem xmlns="urn:jboss:domain:web:1.4" default-virtual-server="default-host" native="false">
    <connector name="http" protocol="HTTP/1.1" scheme="http" socket-binding="http" proxy-address-forwarding="true"/>
    <virtual-server name="default-host" enable-welcome-root="true">
        <alias name="localhost"/>
        <alias name="jboss.localhost"/>
        <!-- 添加负载均衡域名作为别名 -->
        <alias name="esam-dev.abc.com"/>
    </virtual-server>
</subsystem>

如果负载均衡是HTTPS终止模式，可将连接器的scheme属性设为"https"，或依赖X-Forwarded-Proto让JBoss自动识别协议。

3. 优化JSP代码写法

你的JSP代码本身无错，但可以改用JSTL的<c:url>标签生成URL，它会自动处理上下文路径和服务器地址，比直接用request.getContextPath()更可靠：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<link type="text/css" href="<c:url value="/sca/UISfdc.css"/>" rel="stylesheet" />

<c:url>会基于JBoss配置的外部地址自动生成正确URL，避免手动拼接可能出现的问题。

4. 对齐开发与测试环境的LB配置

对比测试环境的Apache Tomcat配置，确保开发环境的LB配置一致，比如是否启用mod_proxy_http模块，是否正确配置反向代理规则：

ProxyPass /emea http://c1234.abc.com/emea
ProxyPassReverse /emea http://c1234.abc.com/emea

ProxyPassReverse会确保响应中的重定向URL被替换为负载均衡地址，这也会影响getContextPath()的返回值。

总结 #

本质上就是要让负载均衡正确传递请求的原始主机信息，同时让JBoss信任并使用这些信息生成外部URL。按上述步骤检查配置后，开发环境的request.getContextPath()应该就能正确返回https://esam-dev.abc.com/emea了。

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