WebSocket连接超时时间不可运行时修改,DCDN平台该配置为静态项,仅控制台提交生效;Vite代理rewrite需用函数精确处理路径;Nginx须设proxy_http_version 1.1并透传Upgrade头;Spring Boot注解端点路径不支持热重载。

WebSocket连接超时时间不能 runtime 修改
DCDN平台的 连接超时时间 是静态配置项,仅在控制台提交后生效,不支持运行时 API 调用或 SDK 动态覆盖。它本质是边缘节点与源站之间 TCP 连接空闲保持的阈值,底层由 CDN 网络设备固件控制。尝试通过前端 JS 修改 WebSocket 实例的 timeout 属性(如 socket.timeout = 120)完全无效——浏览器原生 WebSocket 对象根本没有该属性,也无任何公开接口暴露连接层超时控制。
Vite 开发代理中 rewrite 规则必须匹配完整路径前缀
开发阶段若用 Vite 代理 /wsProxy/chat 到后端 ws://localhost:8080/chat,rewrite 配置必须写成正则全量替换,不能只删前缀。常见错误是写成 rewrite: { '/wsProxy': '' },这会导致 /wsProxy/chat 变成 /chat,看似正确,但若后端实际监听的是 /api/chat,就会 404。正确做法是用函数精确剥离:
export default defineConfig({
server: {
proxy: {
'/wsProxy': {
target: 'ws://localhost:8080',
ws: true,
rewrite: (path) => path.replace(/^\/wsProxy/, '')
}
}
}
})
注意:rewrite 函数只对路径生效,不影响协议、host、query;且必须返回字符串,返回 undefined 会触发默认行为(可能保留原路径)。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。
Nginx 的 proxy_http_version 必须设为 1.1 且显式透传 Upgrade 头
生产环境 Nginx 代理 WebSocket 时,仅配 proxy_pass 不够。两个关键点常被忽略:
-
proxy_http_version 1.1:HTTP/1.0 不支持Connection: upgrade,必须强制升到 1.1 -
proxy_set_header Upgrade $http_upgrade和proxy_set_header Connection "upgrade":缺一不可。前者把客户端发来的Upgrade: websocket头原样转发,后者告诉 Nginx 这个连接要升级,不是普通 HTTP
漏掉任一配置,Nginx 会以 HTTP/1.0 响应 200 或 502,WebSocket 握手直接失败,浏览器控制台报 WebSocket connection to 'wss://...' failed: Error during WebSocket handshake。
Spring Boot 的 ServerEndpointExporter 不支持热重载路径
使用 @ServerEndpoint("/websocket/{id}") 注解定义端点后,路径参数和路径本身在 JVM 启动时即被 ServerEndpointExporter 扫描注册进容器。哪怕你修改了注解值并热部署类文件,旧路径仍保留在内存中,新路径不会自动生效——Spring Boot 没有提供运行时注销/注册 WebSocket 端点的 API。真要改路径,必须重启应用。如果业务需要动态路由(比如按租户隔离),得放弃注解方式,改用 ServerEndpointConfig.Builder + 自定义 Configurator 在启动时动态构建端点,但这会失去 Spring 的依赖注入能力,需手动管理 bean 生命周期。

















