如何在Azure App Service中部署带Netty-SocketIO的Spring Boot应用并解决Socket连接问题

核心问题分析 #

Azure App Service的两个关键限制会导致Socket.IO连接失败：

• 仅对外暴露80/443端口，内部通过动态分配的PORT环境变量转发流量到应用
• 默认禁用WebSocket支持，而Socket.IO依赖WebSocket（或降级轮询）实现双向通信

具体修复步骤 #

1. 调整Socket.IO配置，与Spring Boot共用端口并设置专属路径 #

修改Socket.IO配置，确保和Spring Boot HTTP服务共用同一端口，同时指定路径避免与HTTP端点冲突：

@Value("${server.port:8080}")
private int serverPort;

@Bean
public SocketIOServer userStatusServer() {
    Configuration config = new Configuration();
    config.setHostname("0.0.0.0");
    config.setPort(serverPort);
    // 设置Socket.IO专属路径，防止和HTTP接口冲突
    config.setContext("/socket.io");
    // 补全ACK超时配置
    config.setAckTimeout(60000);
    return new SocketIOServer(config);
}

同时添加Spring Boot WebSocket依赖，确保支持Socket.IO的底层通信：

<!-- pom.xml 中添加依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>

2. 启用Azure App Service的WebSocket支持 #

1. 登录Azure门户，进入你的App Service实例
2. 点击左侧菜单「配置」→「常规设置」
3. 找到「WebSocket」选项，切换为「启用」
4. 保存配置并重启App Service

3. 调整客户端连接参数 #

客户端连接时无需指定端口，直接使用App Service域名，并指定Socket.IO路径：

// 示例客户端代码
const socket = io('https://your-app-name.azurewebsites.net', {
    path: '/socket.io'
});

4. 确保端口配置适配Azure环境 #

Azure会通过PORT环境变量传递内部转发端口，Spring Boot会自动读取该变量，因此不要硬编码端口，配置文件中可设置：

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

5. 日志排查（若问题仍存在） #

1. 进入App Service的「监控」→「日志流」，查看Socket.IO服务器启动日志，确认端口绑定是否正确
2. 检查客户端浏览器控制台的错误信息（如404、连接超时），针对性定位问题

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