部署后无法与STOMP API建立握手连接问题求助

核心排查方向 #

1. 启用GCP App Engine的WebSocket支持 #

App Engine标准环境默认未开启WebSocket，需在app.yaml中配置：

runtime: java17  # 匹配你的Spring Boot运行时版本
instance_class: F2  # F1实例不支持WebSocket，必须用F2及以上
handlers:
  - url: /ws/*
    secure: always
    redirect_http_response_code: 301
    websocket: true  # 关键：启用WebSocket路由

部署时确保该配置文件被正确打包到部署包中。

2. 验证Spring Boot WebSocket端点配置 #

检查后端WebSocketConfig类，确保端点注册正确且允许跨域：

@Configuration
@EnableWebSocketMessageBroker
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {
    @Override
    public void registerStompEndpoints(StompEndpointRegistry registry) {
        registry.addEndpoint("/ws")
                .setAllowedOriginPatterns("*")  // 生产环境建议指定Android客户端的包名/域名
                .withSockJS();  // 可选：若客户端兼容SockJS，可增强兼容性
    }

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

注意：若未使用withSockJS()，客户端需直接通过STOMP协议连接，无需SockJS封装。

3. 确认端口与SSL配置 #

• GCP App Engine的HTTPS服务默认使用443端口，客户端连接地址无需额外指定端口，即wss://mad-grid-api.nn.r.appspot.com/ws是正确的。
• 确保Spring Boot读取GCP提供的环境端口：

  # application.properties
  server.port=${PORT:8080}
  

4. 排除Spring Security拦截 #

若项目启用Spring Security，需允许WebSocket握手请求通过：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/ws/**").permitAll()  // 放行WebSocket端点
            .anyRequest().authenticated();
    }
}

5. 查看GCP日志定位具体错误 #

登录GCP控制台，进入App Engine的日志页面，筛选400状态码的请求，查看后端返回的详细错误信息（如路径不匹配、握手协议不兼容等），这是最直接的问题定位方式。

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