升级package.json依赖后GET /socket.io/端点不存在如何修复

• 基于LoopBack4 websocket示例项目开发，升级package.json内依赖到新版本后，服务无法识别websocket相关路径
• 抛出错误：Endpoint "GET /socket.io/" not found，依赖停留在旧版本时项目运行正常
• 报错截图参考：

该问题由socket.io跨大版本升级的逻辑不兼容导致：原示例适配的是socket.io v2版本，升级到v3/v4版本后，默认路径配置、中间件挂载优先级规则均发生变化。如果沿用旧版代码写法，LoopBack内置路由层会优先拦截/socket.io/*路径下的所有请求，直接返回接口不存在的404错误。

• 调整websocket中间件挂载顺序
  打开src/application.ts文件，将socket.io服务的挂载逻辑移动到应用boot、路由初始化逻辑之前，不要等LoopBack内置路由全部注册完成后再挂载socket.io，否则路由层会先拦截相关请求。核心代码参考：

  // 该段代码需放在this.boot()、this.route()相关逻辑之前执行
  this.expressApp.use('/socket.io', ioServer.serveClient());
  ioServer.attach(this.httpServer);
  

• 显式声明socket.io路径配置
  新版本socket.io不再默认绑定/socket.io路径，初始化Server实例时必须手动传入path参数，否则握手请求会被路由到根路径：

  const io = new Server(this.httpServer, {
    path: '/socket.io',
    // 本地开发可临时放开跨域限制，生产环境按需调整配置
    cors: { origin: "*" }
  });
  

• 清理旧版本冗余兼容代码
  原示例中手动注册GET /socket.io/静态路由、手动配置RestBindings静态资源映射的代码可以全部删除，新版本socket.io会自动处理握手阶段的GET请求，手动注册路由反而会和内置处理逻辑冲突触发404。
• 校验核心依赖版本匹配
  执行npm ls socket.io确认版本，核心依赖需满足版本匹配要求：
  • socket.io 4.x版本需搭配@loopback/websocket 0.9.0及以上版本
  • 前端使用的socket.io-client大版本必须和服务端socket.io版本保持一致，前端初始化连接时也要传入相同的path: '/socket.io'配置

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