为何Node.js请求本地4801端口Docker服务返回501错误？其他客户端可正常访问

异常现象 #

• 尝试调用本机Docker环境中运行的Web服务（映射到宿主机4801端口），使用浏览器、curl、.NET的HttpClient发起请求均可正常访问
• 切换到Node.js环境发起请求，无论采用axios库还是原生http模块，都会收到501 Not Implemented错误
• 系统排查发现本机存在Logitech VC ServiceLayer进程（对应可执行文件ServiceLayer.exe）正在监听4801端口，但Docker依然能成功将服务映射到该端口，仅Node.js的请求无法正常获取Docker服务的响应
• 初步判断返回头中的websocket-sharp相关字段和异常存在直接关联

最小复现场景 #

测试脚本test.js代码：

const axios = require("axios");

axios.get("http://localhost:4801")
  .then(response => console.log(response.data))
  .catch(error => console.log({
    status: error.response.status,
    headers: error.response.headers
  }));

复现执行的命令：

docker run -p 4801:8000 -d crccheck/hello-world
node test.js

实际运行输出：

{
  status: 501,
  headers: { server: 'websocket-sharp/1.0', connection: 'close' }
}

问题根因解释 #

这种跨进程同端口共存的情况是Windows平台HTTP.sys驱动的特性导致的：

• Logitech的ServiceLayer进程没有通过传统的socket bind方式全量占用4801端口，而是通过HTTP.sys的URL命名空间预留机制，按请求头特征做流量分流，因此Docker可以正常绑定4801端口，不会触发端口占用报错
• 该ServiceLayer是基于websocket-sharp框架开发的本地服务，本身只处理WebSocket协议的请求：
  • 浏览器、curl、.NET HttpClient的默认请求头符合流量转发规则，请求会被透传到绑定在4801端口的Docker Web服务
  • Node.js的axios、原生http模块默认生成的请求头特征不符合分流规则，请求会被ServiceLayer进程直接拦截。由于该进程本身不支持标准HTTP GET方法，因此直接返回501 Not Implemented错误，响应头的websocket-sharp/1.0标识也对应这个进程的服务特征

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