部署外部Tomcat的Spring Boot应用HTTP2配置异常排查

核心问题：为什么Spring Boot应用返回HTTP/1.1响应？ #

关键误区：Spring Boot的server.*配置对外部Tomcat无效 #

当你把Spring Boot应用打包为WAR包部署到外部Tomcat时，application.properties中所有以server.开头的配置（包括server.http2.enabled、SSL相关配置）都只会作用于Spring Boot的内嵌Tomcat，外部Tomcat完全不会读取这些配置。你之前在Spring Boot里配置的HTTP2和SSL都是无效的，这是核心误区。

为什么Tomcat自身接口能返回HTTP/2，但Spring应用不行？ #

你的Tomcat配置是正确的（已启用HTTP2并验证有效），问题出在客户端请求协议：

• 访问Tomcat自身接口时，你用的是浏览器，浏览器默认会在HTTPS连接时通过ALPN协议协商使用HTTP2，所以Tomcat返回HTTP/2响应。
• 访问Spring应用时，你用的curl或日志中的请求是HTTP/1.1请求，Tomcat会用对应的协议响应，所以返回HTTP/1.1。

疑问解答 #

1. 是否需要同时在Tomcat和Spring Boot中配置HTTP2？ #

不需要。部署到外部Tomcat时，只需要配置外部Tomcat的HTTP2即可，Spring Boot的HTTP2配置对内嵌Tomcat生效，对外部Tomcat无意义。

2. 客户端调用部署在Tomcat内的Spring应用的通信流程？ #

1. TCP连接与TLS握手：客户端与Tomcat建立TCP连接，完成HTTPS握手（HTTP2通常基于TLS，Tomcat的HTTP2配置已启用SSL）。
2. 协议协商：如果客户端支持HTTP2，会通过ALPN（TLS扩展）直接协商使用HTTP2；或通过HTTP/1.1的Upgrade: h2c头升级到HTTP2（非加密场景）。
3. 请求转发：Tomcat根据请求路径，将请求转发给Spring Boot应用的DispatcherServlet（Spring Boot的核心请求处理Servlet）。
4. 响应返回：Spring Boot处理请求后，将响应返回给Tomcat，Tomcat再通过协商好的HTTP2协议返回给客户端。

解决步骤 #

1. 清理无效配置 #

移除Spring Boot application.properties中的所有server.*配置，包括：

# 这些配置只对内嵌Tomcat生效，外部Tomcat会忽略
server.port=8443
server.ssl.key-store-type=pkcs12
server.ssl.key-store=classpath:springboot.p12
server.ssl.key-store-password=password
server.ssl.key-alias=springboot
server.http2.enabled=true

2. 确保客户端发起HTTP2请求 #

• 浏览器验证：打开开发者工具（F12）→ 网络面板，查看请求的「协议」列，正常会显示h2（HTTP2的标识）。
• curl验证：使用支持HTTP2的curl命令发起请求：

curl -v --http2 https://localhost:8443/demo-0.0.1-SNAPSHOT/getMessage

执行后，日志中会显示HTTP/2 200的响应。

3. 确认Spring Boot WAR包打包正确 #

确保你的Spring Boot启动类继承SpringBootServletInitializer，这是外部Tomcat加载Spring应用的必要条件：

@SpringBootApplication
public class DemoApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(DemoApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

4. 再次验证Tomcat配置 #

确认Tomcat的server.xml中Connector配置正确（你当前的配置是没问题的，可再次确认证书路径和密码正确）：

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="200" SSLEnabled="true">
    <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />
    <SSLHostConfig>
        <Certificate certificateKeystoreFile="ssl/tomcat.jks"
                     certificateKeyAlias="tomcat"
                     certificateKeystorePassword="password"
                     type="RSA" />
    </SSLHostConfig>
</Connector>

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