JavaScript连接WSS服务器失败（Postman可正常连接）求解决方案

我的WSS服务器运行地址：

wss://myurl.azurecontainer.io:8000/

问题现象 #

• Postman等工具连接该服务器一切正常，连接后可接收每秒一次的车辆位置直播流
• 自己开发的网站使用JavaScript连接时失败，报错：

WebSocket connection to 'wss://myurl.azurecontainer.io:8000/' failed:

• 出错代码为ws = new WebSocket(url);，已确认URL完全正确
• 测试过Firefox、Brave、Edge、Chrome多款主流浏览器，均无法连接
• 服务器由Python脚本搭建，基于Kafka流，SSL配置使用ssl_context.load_cert_chain(cert.pem, key.pem)

完整错误信息 #

Event {isTrusted: true, type: 'error', target: WebSocket, currentTarget: WebSocket, eventPhase: 2, …}
isTrusted
: 
true
bubbles
: 
false
cancelBubble
: 
false
cancelable
: 
false
composed
: 
false
currentTarget
: 
WebSocket {url: wss://myurl.azurecontainer.io:8000/, readyState: 3, bufferedAmount: 0, onopen: ƒ, onerror: ƒ, …}
defaultPrevented
: 
false
eventPhase
: 
0
returnValue
: 
true
srcElement
: 
WebSocket {url: wss://myurl.azurecontainer.io:8000/, readyState: 3, bufferedAmount: 0, onopen: ƒ, onerror: ƒ, …}
target
: 
WebSocket {url: wss://myurl.azurecontainer.io:8000/, readyState: 3, bufferedAmount: 0, onopen: ƒ, onerror: ƒ, …}
timeStamp
: 
4396
type
: "error"
[[Prototype]]
: Event

1. 检查SSL证书信任有效性 #

浏览器对SSL证书的信任规则比Postman严格：

• 确认cert.pem是受公共CA签发的证书，自签名证书会被浏览器默认拦截（Postman可手动信任，但浏览器不行）。如果是自签名证书，需在所有客户端浏览器手动导入信任，或更换为Let's Encrypt等免费CA证书。
• 检查证书是否过期、域名是否匹配（证书绑定的域名必须和myurl.azurecontainer.io一致）。

2. 补全证书链配置 #

Python的ssl_context.load_cert_chain需要完整的证书链：

• 确保cert.pem包含服务器证书+中间证书，缺少中间证书会导致浏览器无法验证证书合法性。
• 验证key.pem与cert.pem是配对的密钥对，且服务器进程有读取这两个文件的权限。

3. 配置跨域（CORS）规则 #

如果网站与WSS服务器域名不同，需在WebSocket服务器添加CORS响应头：
以Python websockets库为例，可在握手阶段设置：

async def wss_handler(websocket):
    # 允许指定域名跨域，*代表允许所有（生产环境建议指定具体域名）
    websocket.response_headers["Access-Control-Allow-Origin"] = "https://your-website-domain.com"
    websocket.response_headers["Access-Control-Allow-Credentials"] = "true"
    # 后续业务逻辑

4. 验证网络与端口权限 #

• 确认Azure容器实例的安全组已开放8000端口的入站流量，无防火墙规则拦截浏览器请求。
• 检查Python服务器是否监听0.0.0.0（允许外部访问），而非仅127.0.0.1（仅本地访问）。

5. 获取浏览器详细错误日志 #

打开浏览器DevTools（F12）→ 切换到Network标签，找到WebSocket请求，查看Security或Response标签页，获取更具体的失败原因（比如证书无效、握手协议不兼容等），默认的Error Event信息不足以定位问题。

6. 临时测试非SSL连接 #

临时关闭SSL，改用ws://myurl.azurecontainer.io:8000/测试浏览器是否能连接。如果WS连接正常，说明问题完全出在SSL证书或配置上。

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