HTTPS环境下WSS协议无法连接PHP WebSocket客户端问题

1. 确认WebSocket服务端已配置SSL支持 #

PHP WebSocket服务必须启用SSL才能处理wss连接，以常用的Ratchet框架为例，启动服务时需指定证书与密钥文件：

// Ratchet配置示例
$loop = React\EventLoop\Factory::create();
$webSock = new React\Socket\Server('0.0.0.0:8282', $loop);
// 包装SSL层
$webSock = new React\Socket\SecureServer($webSock, $loop, [
    'local_cert' => '/path/to/your/cert.crt', // 自签名证书路径
    'local_pk' => '/path/to/your/private.key', // 私钥文件路径
    'allow_self_signed' => true, // 本地开发允许自签名证书
    'verify_peer' => false // 本地开发关闭对等验证
]);

若服务端未配置SSL，客户端发起wss连接时会直接触发ERR_SSL_PROTOCOL_ERROR，因为端口无SSL监听。

2. 修复自签名证书信任问题 #

• 手动信任证书：本地环境下，需将自签名证书导入浏览器信任列表。以Chrome为例：
  1. 访问你的HTTPS站点，点击地址栏「不安全」提示，选择「证书」→「详细信息」→「复制到文件」导出证书。
  2. 进入Chrome设置→隐私和安全→安全→管理证书，导入证书并选择「受信任的根证书颁发机构」存储。
• 证书域名匹配：确保自签名证书的「通用名称（CN）」与前端连接的$base域名完全一致（如localhost或自定义域名），域名不匹配会直接触发SSL协议错误。

3. 检查端口与网络连通性 #

• 确认端口监听状态：在服务端执行netstat -an | grep 8282，验证8282端口处于LISTEN状态，说明服务端正在监听wss连接。
• 放行端口防火墙：本地防火墙或服务器安全组必须放行8282端口，否则会出现net::ERR_CONNECTION_TIMED_OUT。Linux下可临时执行iptables -A INPUT -p tcp --dport 8282 -j ACCEPT，生产环境需配置持久化规则。

4. 前端连接配置优化 #

• 验证$base变量有效性：确保$base被正确替换为HTTPS域名（不带http://前缀），比如localhost或你的自定义域名。
• 配置WebSocket库SSL参数：若使用jquery-websocket库，本地开发时可添加SSL跳过验证的配置（生产环境禁用）：

var socket = $.websocket('wss://' + window.location.hostname + ':8282', {
    ssl: {
        rejectUnauthorized: false // 仅本地自签名证书测试用
    }
});

5. 验证SSL协议兼容性 #

通过openssl s_client -connect your-domain:8282命令测试SSL连接，确认服务端使用的是浏览器支持的协议版本（TLS 1.2或TLS 1.3），避免使用SSLv3等过时协议。

内容的提问来源于stack exchange，提问作者Sarvesh Chandra Tripathi