springboot websocket nginx

<think>好的，用户的问题是关于在Spring Boot中集成WebSocket并通过Nginx进行反向代理配置的教程。我需要结合之前的引用内容来提供正确的配置方法。首先，我应该回忆Spring Boot中WebSocket的基本配置步骤，比如添加依赖、创建配置类和处理器。然后，需要将Nginx的配置部分整合进来，特别是针对WebSocket的反向代理设置。之前的引用中提到了几个关键点：使用proxy_http_version 1.1，设置Upgrade和Connection头，调整超时时间，特别是proxy_read_timeout，因为WebSocket是长连接，不能太短。同时，要注意传递Host头和其他必要的信息，比如X-Real-IP等。可能还需要处理跨域问题，不过Spring Boot中可以通过配置解决。用户可能需要完整的步骤，从后端到Nginx配置，所以需要分步骤说明，确保每个部分都清晰。此外，验证配置是否生效的方法也很重要，比如使用在线工具或前端页面测试连接。需要检查是否有常见的错误点，比如忘记升级协议头，或者超时设置不当导致连接断开。最后，生成相关问题，帮助用户进一步了解优化和故障排除。</think>### Spring Boot集成WebSocket与Nginx反向代理配置指南 #### 一、Spring Boot端WebSocket集成 1. **添加依赖** 在`pom.xml`中引入WebSocket依赖： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-websocket</artifactId> </dependency> ``` 2. **配置WebSocket端点** 创建配置类启用WebSocket支持： ```java @Configuration @EnableWebSocketMessageBroker public class WebSocketConfig implements WebSocketMessageBrokerConfigurer { @Override public void registerStompEndpoints(StompEndpointRegistry registry) { registry.addEndpoint("/ws") .setAllowedOrigins("*") // 允许跨域 .withSockJS(); // 支持SockJS回退 } @Override public void configureMessageBroker(MessageBrokerRegistry registry) { registry.enableSimpleBroker("/topic"); // 消息代理前缀 registry.setApplicationDestinationPrefixes("/app"); // 客户端发送消息前缀 } } ``` 3. **实现消息处理器** 编写消息控制器处理客户端请求： ```java @Controller public class WebSocketController { @MessageMapping("/hello") @SendTo("/topic/greetings") public String greeting(String message) { return "Echo: " + message; } } ``` #### 二、Nginx反向代理配置 1. **基础配置** 在`nginx.conf`中添加以下配置，支持WebSocket协议升级： ```nginx server { listen 80; server_name yourdomain.com; location /ws/ { proxy_pass http://localhost:8080; # Spring Boot服务地址 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; # 超时配置（关键参数） proxy_connect_timeout 5s; proxy_send_timeout 15s; proxy_read_timeout 86400s; # 防止Nginx主动断开长连接 # 客户端真实IP传递 proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ``` 2. **关键配置说明** - `proxy_http_version 1.1`：必须使用HTTP/1.1协议 - `Upgrade`和`Connection`头：完成WebSocket协议升级[^2][^4] - `proxy_read_timeout`：建议设置为24小时以上，避免Nginx主动断开连接[^1] 3. **重载配置** ```bash nginx -s reload ``` #### 三、连接验证 1. **前端示例代码** ```javascript const socket = new WebSocket('ws://yourdomain.com/ws/websocket'); socket.onopen = () => console.log('Connected'); socket.onmessage = (e) => console.log('Received:', e.data); ``` 2. **调试工具** 使用Chrome开发者工具查看WebSocket握手过程，确认返回状态码`101 Switching Protocols`。 #### 常见问题排查 1. **连接超时断开** 检查Nginx的`proxy_read_timeout`是否足够长[^1] 2. **跨域问题** 确保Spring Boot配置了`setAllowedOrigins("*")`或具体域名 3. **502 Bad Gateway** 检查后端服务是否运行，以及`proxy_pass`地址是否正确