如何在Apache Tomcat 9中仅针对特定域名实现HTTP转HTTPS

针对你遇到的场景——需要让Tomcat仅对用户直接访问的特定域名执行HTTP转HTTPS，同时忽略负载均衡转发的流量，以下是三种可行方案：

方案一：自定义Tomcat Valve（全局生效） #

Valve是Tomcat的全局拦截组件，可在请求进入应用前统一处理，适合所有部署在该Tomcat实例上的应用统一生效的场景。

实现步骤 #

1. 编写自定义Valve类：继承ValveBase，在invoke方法中完成请求判断与重定向逻辑：

import org.apache.catalina.connector.Request;
import org.apache.catalina.connector.Response;
import org.apache.catalina.valves.ValveBase;
import javax.servlet.ServletException;
import java.io.IOException;

public class DomainSpecificRedirectValve extends ValveBase {
    private String targetDomain = "example.com";
    private String loadBalancerHeader = "X-LB-Request";
    private String loadBalancerHeaderValue = "true";

    @Override
    public void invoke(Request request, Response response) throws IOException, ServletException {
        // 仅处理HTTP请求
        if (!request.isSecure()) {
            String host = request.getHeader("Host");
            // 剥离端口，仅保留域名部分
            if (host != null && host.contains(":")) {
                host = host.split(":")[0];
            }
            // 判断是否为目标域名，且非负载均衡转发的请求
            if (targetDomain.equals(host) && !loadBalancerHeaderValue.equals(request.getHeader(loadBalancerHeader))) {
                String redirectUrl = "https://" + targetDomain + request.getRequestURI();
                if (request.getQueryString() != null) {
                    redirectUrl += "?" + request.getQueryString();
                }
                response.sendRedirect(redirectUrl);
                return;
            }
        }
        // 符合条件则继续处理请求
        getNext().invoke(request, response);
    }

    // 提供配置参数的Setter方法
    public void setTargetDomain(String targetDomain) {
        this.targetDomain = targetDomain;
    }

    public void setLoadBalancerHeader(String loadBalancerHeader) {
        this.loadBalancerHeader = loadBalancerHeader;
    }

    public void setLoadBalancerHeaderValue(String loadBalancerHeaderValue) {
        this.loadBalancerHeaderValue = loadBalancerHeaderValue;
    }
}

2. 部署与配置：
   • 将编译后的DomainSpecificRedirectValve.class文件放入Tomcat的lib目录
   • 在server.xml的<Host>标签内添加Valve配置：

<Valve className="com.yourpackage.DomainSpecificRedirectValve"
       targetDomain="your-specific-domain.com"
       loadBalancerHeader="X-LB-Request"
       loadBalancerHeaderValue="true"/>

3. 负载均衡配置：确保负载均衡转发请求时添加自定义头X-LB-Request: true，让Tomcat识别该请求来自负载均衡。

方案二：自定义Servlet Filter（单应用生效） #

Filter是应用级别的拦截组件，仅对当前部署的Web应用生效，适合只需要在特定应用中实现该逻辑的场景。

实现步骤 #

1. 编写自定义Filter类：

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebFilter("/*")
public class DomainHttpsRedirectFilter implements Filter {
    private String targetDomain;
    private String lbHeader;
    private String lbHeaderValue;

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 从配置中读取参数
        targetDomain = filterConfig.getInitParameter("targetDomain");
        lbHeader = filterConfig.getInitParameter("lbHeader");
        lbHeaderValue = filterConfig.getInitParameter("lbHeaderValue");
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) servletRequest;
        HttpServletResponse response = (HttpServletResponse) servletResponse;

        if (!request.isSecure()) {
            String host = request.getHeader("Host");
            if (host != null && host.contains(":")) {
                host = host.split(":")[0];
            }
            String lbRequestValue = request.getHeader(lbHeader);
            // 判断条件：HTTP请求、目标域名、非负载均衡流量
            if (targetDomain.equals(host) && !lbHeaderValue.equals(lbRequestValue)) {
                String redirectUrl = "https://" + targetDomain + request.getRequestURI();
                if (request.getQueryString() != null) {
                    redirectUrl += "?" + request.getQueryString();
                }
                response.sendRedirect(redirectUrl);
                return;
            }
        }
        // 符合条件则继续执行后续逻辑
        filterChain.doFilter(request, response);
    }

    @Override
    public void destroy() {
        // 清理资源（按需实现）
    }
}

2. 配置Filter：
   • 如果未使用@WebFilter注解，可在应用的web.xml中添加如下配置：

<filter>
    <filter-name>DomainHttpsRedirectFilter</filter-name>
    <filter-class>com.yourpackage.DomainHttpsRedirectFilter</filter-class>
    <init-param>
        <param-name>targetDomain</param-name>
        <param-value>your-specific-domain.com</param-value>
    </init-param>
    <init-param>
        <param-name>lbHeader</param-name>
        <param-value>X-LB-Request</param-value>
    </init-param>
    <init-param>
        <param-name>lbHeaderValue</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>DomainHttpsRedirectFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

3. 负载均衡配置：同方案一，确保转发请求时添加X-LB-Request: true头。

方案三：使用Tomcat RewriteValve（无代码配置） #

利用Tomcat自带的RewriteValve，通过配置rewrite规则实现条件重定向，无需编写代码，适合快速实现的场景。

实现步骤 #

1. 启用RewriteValve：在server.xml的<Host>标签内添加：

<Valve className="org.apache.catalina.valves.rewrite.RewriteValve"/>

2. 编写rewrite规则：在Tomcat的conf/Catalina/[你的主机名]/目录下创建rewrite.config文件，添加如下规则：

# 仅对HTTP请求、目标域名、非负载均衡流量执行重定向
RewriteCond %{HTTPS} off
RewriteCond %{HTTP_HOST} ^your-specific-domain.com(:80)?$
RewriteCond %{HTTP:X-LB-Request} !true
RewriteRule ^(.*)$ https://your-specific-domain.com$1 [R=301,L]

规则说明：

• %{HTTPS} off：匹配HTTP请求
• %{HTTP_HOST} ^your-specific-domain.com(:80)?$：匹配目标域名（带/不带80端口）
• %{HTTP:X-LB-Request} !true：排除带有负载均衡标识头的请求
• RewriteRule：将请求重定向到对应的HTTPS URL，R=301表示永久重定向，L表示终止后续规则

3. 负载均衡配置：同前两个方案，确保转发请求时添加X-LB-Request: true头。

各方案对比 #

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