Java 11、Glassfish 6.2.1与Java EE 9环境WebSocket连接失败如何解决

1. 容器版本兼容性排查 #

• 你参考的Glassfish教程适配Java EE规范，切换到Tomcat时需注意版本匹配：
  • 优先使用Tomcat 9.x版本，Tomcat 10及以上版本将Java EE的javax命名空间全部改为jakarta，你现有代码的javax.websocket相关注解会完全失效，如要使用Tomcat 10需替换所有相关依赖和导入包路径。
  • 确认Tomcat版本本身内置WebSocket实现，无需额外导入公共依赖。

2. IntelliJ部署配置排查 #

• 打开IntelliJ右上角Tomcat的Run/Debug Configurations面板，切换到Deployment标签页：
  • 确认你部署的war/war exploded包的Application context配置为/chat，和你前端连接路径ws://localhost:8080/chat/ws的上下文路径完全一致，IntelliJ默认会自动生成类似/chat-app_war_exploded的上下文路径，会直接导致404。

3. 端点扫描配置排查 #

• 检查ChatServer.java是否添加了合法的包声明（比如package com.example;），放在无包名的默认根目录下的类，Tomcat不会扫描其@ServerEndpoint注解，必然无法注册端点。
• 检查项目web.xml（如果存在）的web-app版本号，必须大于等于3.1才能支持WebSocket注解扫描，参考配置：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
</web-app>

• 如注解扫描仍不生效，可手动添加配置类主动注册端点：

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
import org.apache.tomcat.websocket.server.WsSci;
import java.util.Collections;

@WebListener
public class WebSocketConfig implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        WsSci wsSci = new WsSci();
        wsSci.onStartup(Collections.singleton(ChatServer.class), sce.getServletContext());
    }
}

4. 依赖补充（可选） #

如果Tomcat版本较低识别不到javaee-web-api中的WebSocket接口，可在pom.xml中额外添加Tomcat官方WebSocket依赖：

<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-websocket</artifactId>
    <version>9.0.65</version>
    <scope>provided</scope>
</dependency>

5. 连通性验证 #

先在浏览器访问http://localhost:8080/chat，确认应用可以正常打开静态资源，再测试WebSocket连接，排除应用本身部署失败的问题。

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