博客聊天室上线了,顺便聊聊踩坑记录

3255 字
16 分钟
博客聊天室上线了,顺便聊聊踩坑记录
博客聊天室上线了,顺便聊聊踩坑记录

最近这阵子博客更新慢了点,其实我私底下一直在忙着做这个实时聊天室页面。

前前后后改了好几版,今天总算是把它折腾上线了!

传送门先放在这里,大家可以直接点进去体验:👉 冷汐的实时聊天室

平时文章底下的评论区和留言板都是异步交流,有时候写了新文章或者折腾了什么小工具,想和来访的朋友即时聊两句,或者挂在后台一起听听歌,就总觉得差点意思。

前阵子刚好有点空闲,我就想着干脆在博客里开个聊天室页面。顺便把之前写的 Playlist Out 歌单系统也接进来,搞一个大家能一起点歌的电台。

我最开始的想法其实特别天真:不就是搭个 WebSocket 服务,前端连上去收发消息,再放个 <audio> 标签放放歌吗?这能有多难?

事实证明,我又被自己天真的想法给坑了 🫠

现在它长什么样?#

折腾了一周多之后,现在的聊天室基本被我打磨得挺顺手了。整体基于 Svelte 5 构建,在电脑上看是一个完整的三栏布局:

聊天室桌面端三栏全貌
聊天室桌面端三栏全貌

其实看上面这一张大截图,整个页面的核心功能基本就全涵盖了:

  • 左侧是房间与茶友名录:分了纯站内吹水的 #闲聊 和接入了跨站大厅的 #互联茶室,下面是在线茶友列表,能直观看到哪些朋友在线、哪些暂时离开或离线;
  • 中间是主要的消息流:参考了类似 Telegram 的云朵气泡风格,支持 Markdown 排版、代码块按需高亮和一键复制,也加上了表情回应(Reactions)、贴纸和消息就地编辑;
  • 右侧是全功能点歌台:把 Playlist Out 歌单库搬了进来,不仅能搜歌点歌、切歌投票,还可以展示全屏专辑大封面与实时滚动歌词。

这里还有一个我花了不少心思调整的细节:迷你播放条的位置。

很多人做网页播放器习惯把迷你条扔在页面最底部。但我自己在聊天打字的时候总觉得底栏放播放条特别碍手,不仅容易和输入框打架,还容易误触。

所以这次我把它改成了完全吸顶:

点歌台切换到搜索时,顶栏无缝替换为吸顶迷你播放条
点歌台切换到搜索时,顶栏无缝替换为吸顶迷你播放条

在右侧点歌台里,只要你从正在播放切去搜索、歌单库或者播放队列,面板顶部的标题栏就会自动无缝替换成迷你播放条。挑歌的同时,抬头就能看到当前播到哪句歌词,随时能切歌。

在手机端也是一样的逻辑。手机屏幕窄,如果底栏再挤一个播放器,键盘一弹起来整个界面直接没法看。所以我把迷你条直接吸顶挂在顶部导航栏正下方,中间完整留给消息气泡,底部清爽留给输入框。左滑唤出房间列表,右滑唤出点歌台,单手操作起来顺畅很多。

界面看着像那么回事了,但开发过程中遇到的几个大麻烦,差点没把我折腾吐。

多人点歌同步:最折腾的深坑#

点歌台绝对是我这次死磕最久的地方。

两个人同时进房间听歌,“一起听”的核心在于进度必须绝对一致。你总不能那边都唱到高潮副歌了,我这边前奏才刚走完吧?

刚开始我想得很简单:谁点了歌,服务端就把音频直链广播出去,所有人客户端各自播放。

结果一测才发现完全不是那么回事。每个人的电脑和手机本地时钟并不完全准,有的快几秒,有的慢几秒,再加上网络延迟,一首歌放完大家的时间轴就已经各跑各的了。

如果靠前端定时去拉服务端的进度,然后强制调用 audio.currentTime = serverTime,只要网络稍有抖动,播放器就会瞬间卡壳、重新缓冲,耳朵里能明显听到“咔哒”一声爆音或者画面微跳,体验稀烂。

更离谱的是早期的容错机制。有天晚上测试,一个朋友网络不好卡了一下,他的浏览器加载音频超时报错了。前端把错误上报给后端,后端居然误以为“这首歌的音源失效了”,反手一个切歌指令,直接把全房间正听得入神的人强行切到了下一首 🙃

大家正聊着天,歌突然被掐断切了,场面一度非常尴尬。

为了彻底治好这毛病,我把同步逻辑整个推翻重写了:

  1. 未来时间轴起播:切歌的时候,服务端不再让大家“立刻播”,而是广播一个预留了 2 秒网络余量的绝对时间戳(now + 2000ms)。所有人的浏览器收到通知后先在后台把音频分片缓冲好,等统一的时间一到,大家一起起跑。
  2. 微调速率平滑追赶:各个客户端通过单调时钟计算自己和服务器的时间差。如果有几十毫秒的微小偏差,前端绝对不再去调 currentTime,而是悄悄把播放速率微调到 1.02x 或者 0.98x。用极其微小的变速慢慢把进度追平,人耳听起来完全是无感的。
  3. 故障隔离与流式分片:音源直链容易有时效或跨域限制,我在 VPS 后端专门加了一套流式代理,完整支持 HTTP 206 断点续传。一个人卡顿只由他自己的浏览器重试,绝不允许再波及到整间房的人。

把这套改完之后,协同播放总算是彻底稳下来了。

国内打开要转十几秒?把大包彻底拆掉#

功能跑顺之后,我把链接发给几个国内的朋友测试,结果大家的第一反馈居然是:

“怎么这么卡?打开页面白屏转圈转了十几秒!”

“图片和边框都出来了,但我点那个按钮完全没反应啊?”

我当时一看就懵了,赶紧开控制台抓包看。

根因其实很典型。我的聊天服务器在轻量境外 VPS 上,静态资源虽然有边缘加速,但初版为了省事,我把代码高亮解析器(Shiki)、复杂的点歌台组件(包括巨大的歌单库解析和搜索逻辑)全给一股脑打包进了首屏的主 JS 块里。

结果就是整个 JS 包体积飙到了几百 KB。国内网络稍微弱一点,浏览器就得先漫长地把这几百 KB 下载下来,再花大量时间去编译解析和执行水合(Hydration)。在水合完成之前,整个页面看起来虽然画出来了,但底层事件根本没绑定上,点上去当然毫无反应。

再加上境外 VPS 的 WebSocket 和音频代理在国内直连时,初次建立连接要经历漫长的 DNS 查询和 TLS 握手,卡上加卡,体验直接雪崩。

知道原因就好办了,我立马给首屏动了一场“大手术”:

  • 极致按需拆包:把点歌台面板(MusicPanel.svelte)和代码高亮引擎全改成了动态异步 import()。如果一个访客进聊天室只是为了打字水群,点歌台的代码永远不会被下载;只有当他真正点击打开音乐抽屉的那一刻,代码才会异步拉取下来。
  • 连接预先预热:在 HTML 的 <head> 里直接塞入 dns-prefetch 和 preconnect。用户刚点进网页,浏览器还在解析 HTML 头部的阶段,就已经在后台并行和聊天服务器进行 DNS 解析与 TLS 握手了。

这一套重构下来,首屏主包体积直接被砍掉了大半。国内再打开页面,初次可用时间直接从原来的十几秒压缩到了毫秒级,点不动的假死感彻底消失了 ⚡

接入“互联茶室”:撞上 Matrix 协议的权限坑#

除了站内聊天,这次最让我觉得有意思的其实是 #互联茶室 这个房间。

先澄清一下:这个互联大厅并不是我自己建起来的。它是前阵子由独立博主 朝朝听雨 发起并搭建的一套基于 Matrix 联邦协议 的跨站聊天网络(#lobby:detached.online)。听雨茶室、Detached、GBK 等几个博主的小站都连在里面。

我觉得“不同独立博客之间能够跨站实时串门”这个想法特别浪漫,不用大家都跑到同一个平台去,只要在各自的博客里挂个客户端就能跨域名唠嗑,于是我也屁颠屁颠地跑去对接了。

但接入分布式协议的时候,还是踩了权限的坑。

最开始我的服务端网关以为这个大厅是公开的,给博客的新访客生成了匿名凭据后,就直接调 Matrix 接口发信。

结果新访客敲下回车,迎面而来的直接是一排红色的 403 M_FORBIDDEN 报错:

Auth check failed: sender's membership leave is not join

去翻了 Matrix 官方规范我才弄明白:上游房间为了防机器人刷屏,随时可能从公开房间切换成邀请制(Invite Only)。新访客生成的账号由于不在房间的成员列表里(membership 状态是 leave),直接发消息会被服务端当成非法入侵当场击毙。

为了让访客能丝滑发信,最后在网关层重构了一套流程:

  • 访客在互联茶室发第一句话前,先由我自己的站长管理员账号(PL 100)主动向 Matrix 发送邀请指令,强行把新账号拉进房间;
  • 紧接着客户端自动确认 join;
  • 万一遇到跨站网络抖动导致入群卡顿,网关会瞬间降级成 Admin Proxy(管理员代发),由站长账号代发出来并附带来源站点签名,保证绝对不会吞掉用户的任何一句话。

永远在整活的 Safari 和手机端细节#

最后就是各种奇奇怪怪的前端兼容性问题了,其中贡献 bug 最多的依然是 Safari。

在 Chrome 和 Edge 里面渲染得极其丝滑圆润的 SVG 气泡尖角和圆形头像,一放到 Safari 里,由于 WebKit 对弹性盒子(Flexbox)和嵌套矢量 viewBox 的奇葩计算逻辑,头像经常会被直接挤压成一条线或者扁面条。最后排查了半天,只能给每个矢量外层老老实实加上 flex-shrink: 0 和严格的像素保护。

还有 iOS 的音频自动播放限制。如果不先用手指点一下屏幕,Safari 坚决不允许网页自己在后台起播音频。所以我又加了一层手势感知,用户进房间后只要点一下界面任意地方,就会无感唤醒音频上下文,避免静音卡死。

另外在手机端,置顶横幅和吸顶播放条之间曾经露出了极其刺眼的 1 像素缝隙,折叠菜单弹出时层级偶尔会被播放条挡住……这些琐碎的小毛病,都在这几天一边用一边修的过程中慢慢抹平了。

现在总算稳了,欢迎来坐坐#

从最初以为只要写几行代码,到最后硬生生把点歌时钟校准、流式代理、Matrix 入群门控、动态拆包和多端适配全给折腾了一遍,头发掉了不少,但看着现在能在网页里丝滑地一边听歌一边跨站唠嗑,成就感还是挺足的。

目前整个聊天服务在 VPS 上稳定跑着,日常挂在后台摸鱼听听歌非常舒服。

如果大家逛博客的时候有空,欢迎随时点进 /chat 坐坐。随便发两条消息吹吹水、在点歌台点首喜欢的歌,也顺便帮我测测看还有没有漏掉的 bug ☕。

另外,如果你也是独立博主,也想把自己的小站接入到这个跨站互联大厅里来,非常推荐去看一下朝朝听雨整理的对接指南:

👉 听雨茶室互联接入指南(rainzt.cn)

按照他的教程把 Matrix 协议对接好之后,大家就可以在各自的博客里互相串门了!

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!

打赏
博客聊天室上线了,顺便聊聊踩坑记录
https://lengxiqwq.com/posts/博客聊天室上线了顺便聊聊踩坑记录/
作者
冷汐OωO
发布于
2026-11-21
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
冷汐OωO
你好谢谢小笼包再见
me@lengxiqwq.com
3197635836
公告
最近还在折腾 Live Photo Box,一个实况照片合成、拆分、转换和修复的桌面端工具箱。 这段时间主要在把一部分底层媒体与协议处理逐步迁移到 C++ Native 核心,希望批量处理更加稳定,新版本预计一个月左右和大家见面 OωO!
分类
标签
最新动态
最新评论
站点统计
项目
4
动态
18
文章
9
相册
9
总字数
23,337
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
GitHub Actions
托管平台
Cloudflare Pages
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录