Spring 4.2.x wss握手失败：Upgrade header为null，求WildFly配置方案

我之前在WildFly上配置Spring STOMP over WSS时踩过完全一样的坑，给你分享下我当时一步步解决的方案，应该能帮你搞定：

一、先把WildFly的HTTPS基础配置做扎实 #

WSS是基于HTTPS的，所以首先得确保WildFly本身的HTTPS服务是正常运行的：

• 找到WildFly的核心配置文件，独立模式下是standalone.xml，域模式用domain.xml
• 定位到<subsystem xmlns="urn:jboss:domain:web:2.2" ...>这个Web子系统节点，添加（或确认已存在）HTTPS连接器：

<connector name="https" protocol="HTTP/1.1" scheme="https" socket-binding="https" secure="true">
    <ssl name="ssl" 
         key-alias="你的密钥别名" 
         password="密钥库密码" 
         certificate-key-file="你的密钥库路径，比如../standalone/configuration/your-keystore.jks" 
         protocol="TLSv1.2" 
         verify-client="false"/>
</connector>

这里的密钥库可以用JDK自带的keytool生成，命令大概是keytool -genkey -alias your-alias -keyalg RSA -keystore your-keystore.jks -validity 3650，记得把生成的密钥库放到WildFly能访问的路径下。

二、开启WildFly的WebSocket子系统支持 #

WildFly需要专门的WebSocket子系统来处理WSS请求，确保配置里有这个模块：

• 在配置文件里找<subsystem xmlns="urn:jboss:domain:websockets:1.0"/>节点，如果没有就手动加上。WildFly 8及以上版本默认应该自带，但旧版本可能需要确认是否启用了这个子系统。

三、调整Spring的WebSocket配置适配HTTPS #

虽然你HTTP下正常，但HTTPS环境下要微调Spring的配置：

• 找到你的WebSocket配置类（继承AbstractWebSocketMessageBrokerConfigurer的那个），在注册STOMP端点时，明确允许前端的HTTPS域名，同时保留SockJS回退（兼容不同环境）：

@Override
public void registerStompEndpoints(StompEndpointRegistry registry) {
    registry.addEndpoint("/你的WebSocket端点路径")
            .setAllowedOrigins("https://你的前端域名.com") // 允许跨域的HTTPS域名
            .withSockJS(); // 启用SockJS，自动适配WSS/WS
}

消息代理的配置不用改，保持原来的就行：

@Override
public void configureMessageBroker(MessageBrokerRegistry config) {
    config.enableSimpleBroker("/topic", "/queue");
    config.setApplicationDestinationPrefixes("/app");
}

四、前端客户端的连接调整 #

前端要确保用正确的地址连接：

• 如果直接用原生WebSocket：

const socket = new WebSocket('wss://你的域名.com/你的应用上下文/你的WebSocket端点路径/websocket');
const stompClient = Stomp.over(socket);

stompClient.connect({}, (frame) => {
    console.log('连接成功:', frame);
    // 订阅消息等逻辑
}, (error) => {
    console.error('WSS连接失败:', error);
});

• 更推荐用SockJS，它会自动处理WS/WSS的切换，兼容性更好：

const sock = new SockJS('https://你的域名.com/你的应用上下文/你的WebSocket端点路径');
const stompClient = Stomp.over(sock);

注意这里用的是https://开头的地址，SockJS会自动转换成WSS协议。

五、排查常见坑点 #

• 后台报Upgrade header: null：大概率是请求没走到WildFly的WebSocket处理器，检查HTTPS连接器的端口（默认8443）是否正确，前端请求是不是真的发往了这个端口，还有应用的上下文根有没有写错。
• 前端400错误：除了地址问题，还要检查WildFly的虚拟服务器配置，确保你的应用被正确映射到了对应的域名下，另外如果是自签名证书，浏览器会拦截，需要先信任证书（生产环境建议用正规CA签发的证书）。
• 跨域问题：如果前端和后端域名不同，一定要在Spring的setAllowedOrigins里加上前端的HTTPS域名，不然会被拦截。

内容的提问来源于stack exchange，提问作者Cara.Zhou