WebSocket连接与HTTP认证失败求助：缺失何种凭证及配置位置

阿华AIGC实验室

2026-5-13

解决WebSocket连接的HTTP认证失败问题

看起来你碰到的是WebSocket请求被服务器要求HTTP身份验证，但没有提供有效凭证导致的连接失败。咱们一步步拆解这个问题：

首先，错误信息HTTP Authentication failed; no valid credentials available直接指向——你的WebSocket连接请求需要携带认证凭证，但当前请求里没有，或者凭证无效。常见的两种情况是Basic Auth（基础身份验证）或者基于Token的认证（比如JWT），先从最常见的Basic Auth入手排查：

1. 先快速验证是否是凭证问题

你可以先在WebSocket URL里直接带上用户名和密码测试（仅限测试环境，生产环境别这么干），格式是：

ws://your-username:your-password@192.168.x.xx/admin/comms

如果这么改后能成功连接，那基本确定是缺少Basic Auth凭证的问题。

2. 正确配置凭证的几种方式

方式一：在前端代码里添加认证请求头

如果是你自己开发的前端应用，初始化WebSocket的时候可以手动带上认证头：

对于Basic Auth：先把用户名:密码做Base64编码，然后添加Authorization请求头：

const authCredentials = btoa('your-username:your-password');
const socket = new WebSocket('ws://192.168.x.xx/admin/comms', {
  headers: {
    'Authorization': `Basic ${authCredentials}`
  }
});

如果是Token认证（比如JWT），就换成Bearer格式的请求头：

const authToken = 'your-jwt-token';
const socket = new WebSocket('ws://192.168.x.xx/admin/comms', {
  headers: {
    'Authorization': `Bearer ${authToken}`
  }
});

方式二：确保浏览器自动携带会话凭证

如果这个WebSocket端点是和你的后台应用共享登录会话的（比如用Cookie保持登录），那要检查：

你的前端是否已经登录，并且Cookie的SameSite设置允许在WebSocket请求中携带（如果是跨域场景，需要设置SameSite=None同时开启Secure）；
服务器端是否配置了允许WebSocket请求携带Cookie（比如Nginx里要设置proxy_set_header Cookie $http_cookie;）。

方式三：让浏览器保存凭证

如果是Basic Auth，你可以在浏览器访问对应的HTTP页面（比如http://192.168.x.xx/admin），输入用户名密码后选择“保存密码”，之后浏览器会自动在WebSocket请求里带上这些凭证。你也可以手动在浏览器的密码管理器里添加对应IP的凭证（比如Chrome在「设置>隐私和安全>密码管理器」里操作）。