未主动使用WebSocket却在浏览器控制台报错的原因排查

可能的触发原因 #

• 第三方依赖自动启用：项目里的某些依赖（比如React开发环境的热重载工具、状态同步库、监控SDK）可能默认开启WebSocket连接。比如react-scripts在开发模式下靠WebSocket实现热模块替换（HMR），如果部署时没彻底切换到生产模式，或者构建配置残留了开发环境的设置，就会触发这个请求。
• Azure平台默认配置干扰：Azure App Service的部分扩展或默认设置可能会尝试建立WebSocket连接，比如诊断工具、实时监控功能，或是你不小心启用了和WebSocket相关的站点扩展。
• 遗留/误引入的代码：项目里可能存在被忽略的代码片段（比如复制的示例、调试残留代码），间接引入了WebSocketClient.js这类文件，触发连接请求。
• CDN或代理配置问题：如果前端用了Azure CDN或反向代理，代理配置可能错误地将请求转发到WebSocket端口，或是CDN的特性触发了WebSocket连接尝试。

排查建议 #

• 检查package.json里的依赖，确认是否有带热重载、实时同步功能的库，确保生产构建时已禁用这些功能。比如react-scripts的生产构建会自动关闭HMR，但自定义webpack配置的话要确认相关插件已移除。
• 在项目代码库中搜索wss://、WebSocket、WebSocketClient.js相关字符串，定位触发请求的源头。
• 查看Azure App Service的配置：在“配置”->“常规设置”里检查WebSocket是否被意外启用，或是有相关站点扩展在运行。
• 检查前端构建产物，确认打包后的代码没有包含开发环境的WebSocket相关逻辑。

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