微信本身不直接暴露WebSocket客户端接口，但你在微信小程序或微信内置浏览器打开的H5页面里，都可以用标准WebSocket协议连接服务器端口；小程序的硬性条件是必须使用wss://加密连接、域名完成备案并在小程序后台配置socket合法域名，H5页面则要保证页面协议与WebSocket协议一致、服务器端口对微信内置浏览器放行。
微信里能用WebSocket连服务器端口的两种场景
很多人搜“微信怎么用wedsocket连服务器端口”，其实是把微信当成一个运行环境，微信不提供类似Node.js的ws模块，也不让你在聊天窗口里直接调WebSocket，真正能落地的场景只有两类：
- 微信小程序：通过
wx.connectSocket接口连接服务器端口，底层走WebSocket协议。 - 微信内置浏览器打开的H5页面：页面里用原生
new WebSocket()或封装库（如Socket.IO）连接服务器端口。
微信小游戏本质也是小程序体系,接口一致，下文不单独展开，你如果是在公众号文章里想直接跑WebSocket，那做不到，公众号文章只能跳转小程序或H5。
微信小程序websocket连接服务器端口需要哪些前置配置？
这是最容易卡住的一步,不少开发者本地ws://localhost:3000调通了，一上真机就报“连接失败”，多半是漏了下面三项。
服务器域名和端口必须在小程序后台登记
登录微信公众平台,进入“开发管理-开发设置-服务器域名”，找到“socket合法域名”，这里填写的格式是wss://你的域名:端口，如果端口是默认的443，可以省略端口号；如果用的是8443、9443这类非标准端口，必须显式写出来，域名不能是IP地址，也不能带路径。
小程序端只认wss，不认ws
wx.connectSocket的url参数必须以wss://开头，你在本地开发时可以在微信开发者工具里勾选“不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书”，用ws://127.0.0.1:3000临时调试，但真机预览和发布版本一定走wss。行业共识认为，小程序强制wss是为了避免明文传输被中间人劫持，这一限制从2017年前后延续至今。
服务器端口要真实监听且证书有效
服务器上WebSocket服务监听的端口,必须和你在后台登记的端口一致，反向代理场景下，Nginx把443转发到内网的3000，后台登记wss://api.example.com即可，证书要由受信任CA签发，自签证书在小程序真机上会被拒绝。
实操路径可以按这个顺序走：
- 服务器端启动WebSocket服务,监听目标端口。
- 用
openssl s_client -connect 你的域名:端口验证TLS握手是否正常。 - 小程序后台添加socket合法域名,格式
wss://域名:端口。 - 代码里调用
wx.connectSocket({url: 'wss://api.example.com:8443/ws'})。 - 真机预览,观察
onOpen、onError回调。
微信H5页面websocket连服务器端口失败怎么排查？
微信内置浏览器（安卓多为X5内核，iOS为WKWebView）对WebSocket的支持本身没问题，但页面环境会带来额外限制，你遇到连接失败，按下面清单逐项排除。
先看协议是否混合内容
如果H5页面是https://打开的，页面里却写new WebSocket('ws://api.example.com:8080/ws')，浏览器会直接拦截混合内容，微信内置浏览器同样遵守这条规则，把WebSocket地址换成wss://，同时服务器端口开启TLS，是最直接的解法。
端口是否被运营商或防火墙拦截
微信内置浏览器走的是手机网络,部分运营商会对非常用端口做限制。据统计，近年来移动网络对非标准端口的WebSocket握手成功率明显低于443端口。 建议把WebSocket服务挂在443或8443上，用Nginx做路径分流：
wss://api.example.com/ws→ 内网0.0.1:3000wss://api.example.com/api→ 内网0.0.1:8080
这样对外只暴露443端口,排查范围小很多。
检查握手阶段的Origin和Cookie
WebSocket握手本质是HTTP升级请求,如果你的服务器对Origin头做了白名单校验，记得把https://你的H5域名加进去，微信内置浏览器在跨域场景下可能不携带第三方Cookie，如果服务端依赖Cookie做鉴权，建议改用URL参数传token或首帧消息鉴权。
排查顺序可以记成一句话：先看控制台报错是“混合内容”还是“连接被拒”，再查端口连通性，最后看服务端握手日志。
微信小程序WebSocket与轮询、SSE连接服务器端口对比
选型时别只盯着WebSocket,下面这张表把常见方案放在一起，端口和协议要求一目了然。
| 方案 | 微信小程序支持情况 | 端口要求 | 加密要求 | 适用场景 |
|---|---|---|---|---|
| WebSocket | 原生wx.connectSocket |
任意端口，需后台登记 | 必须wss | 双向实时通信、聊天、协同 |
| HTTP轮询 | wx.request |
443或已备案端口 | 建议https | 低频状态同步、兼容性优先 |
| SSE | 小程序无原生EventSource | 需自行封装 | 必须https | 服务端单向推送 |
业内专家指出，在小程序实时通信场景中，WebSocket相比短轮询能显著降低请求数量和延迟抖动，但连接保活和断线重连需要开发者自己处理。 如果你只是偶尔拉取一次订单状态，轮询更省事；如果是聊天室或实时位置共享，WebSocket更合适。
关于微信WebSocket连服务器端口的常见疑问
微信小程序websocket连接服务器端口可以用ws不加wss吗？
开发工具里勾选“不校验合法域名”后可以临时用ws://调试，但真机和线上版本必须wss://，这是小程序平台的硬性校验，不是服务器端能绕过的，你如果把ws://地址提交到体验版，wx.connectSocket会直接触发onError。
微信H5页面连接服务器8080端口失败，但浏览器直接打开正常，怎么回事？
微信内置浏览器对非标准端口的放行策略比桌面浏览器更保守,先确认页面本身是https，再把WebSocket地址改成wss://并换到443或8443端口，如果仍然失败，用手机抓包看握手请求有没有到达服务器；没到达就是网络层拦截，到达了但返回非101状态码就是服务端配置问题。
微信小程序和微信小游戏用WebSocket连接服务器端口有区别吗？
接口层面没有区别,小游戏同样调用wx.connectSocket，域名配置也在同一个小程序后台完成，差异在于小游戏运行环境对内存和后台挂起更敏感，WebSocket连接在切后台一段时间后可能被系统回收，需要在onShow里做重连检测，事实是：小游戏没有独立的WebSocket接口，配置入口和小程序共用。
记住一条主线：小程序走wss加后台域名登记，H5走协议一致加端口放行，把这两步做对，微信里用WebSocket连服务器端口就不会卡在“连不上”上。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/795927.html
