通过cPanel应用管理器运行socket.io出现异常是否为bug？

问题排查结论 #

这既不是cPanel的bug也不是Socket.io的bug，属于cPanel共享主机的默认配置限制和你操作时对反向代理逻辑的理解疏漏。

原因说明 #

1. cPanel共享主机的应用管理器默认依托Apache/Nginx做反向代理，将用户请求转发到Node.js进程。你填写的Base Application URL本质是反向代理的请求匹配前缀，大部分共享主机服务商默认只给/前缀的反向代理规则配置了WebSocket升级支持，你填写子路径时规则里没有WebSocket转发逻辑，Socket.io的握手请求会直接失败，表现为应用无法运行，这是服务商的默认配置限制，不是平台bug。

Base Application URL：输入应用的基础URL，注册应用后可通过该URL访问。
上述提示是通用说明，没有标注WebSocket场景下的配置限制，很容易造成误解。

2. 你将Base Application URL设为/后，反向代理会把指向该域名的所有请求全部转发到Node.js进程，而非仅匹配/myapp前缀的请求，自然会出现整个域名被Node.js服务接管的情况。

解决方案 #

方案1（优先选择） #

联系你的主机服务商，要求对方给/myapp前缀的反向代理规则添加WebSocket升级支持，配置完成后你直接将Base Application URL填为/myapp即可，反向代理只会转发/myapp开头的请求到Node.js服务，不会影响域名其他路径的使用，也不需要在代码里写死路径前缀。

方案2（服务商不支持改配置时选择） #

自行在Node.js代码中加路由过滤规则，主动忽略非/myapp前缀的请求，示例代码如下：

1. 全局路由过滤中间件，放在所有路由定义之前：

app.use((req, res, next) => {
  // 非/myapp开头的请求直接返回404，也可根据需求调整为返回静态资源
  if (!req.path.startsWith('/myapp')) return res.sendStatus(404)
  next()
})

2. 配置Socket.io的服务端路径，避免握手请求匹配失败：

const io = require('socket.io')(server, {
  path: '/myapp/socket.io'
})

3. 前端连接时同步指定Socket.io路径：

const socket = io('https://example.com', {
  path: '/myapp/socket.io'
})

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