websocket连接失败主因是nginx未透传upgrade头部，需配置proxy_set_header upgrade $http_upgrade、connection "upgrade"及proxy_http_version 1.1；服务端须用upgrader.upgrade()并启用ping/pong心跳，日志推送应避免共用文件读取器、确保换行符和编码正确。
WebSocket 连接建立失败：dial: failed to negotiate protocol
Go 的 gorilla/websocket 默认要求客户端发起的 Upgrade 请求中包含正确的 Sec-WebSocket-Version 和 Sec-WebSocket-Key，但很多前端直接用 new WebSocket("ws://...") 是合规的；真正出问题的往往是反向代理（比如 Nginx）没透传 WebSocket 头部。
常见错误现象：dial: failed to negotiate protocol 或浏览器控制台报 Error during WebSocket handshake: Unexpected response code: 200。
- 确认 Nginx 配置里有这三行（缺一不可）：
proxy_set_header Upgrade $http_upgrade;<br>proxy_set_header Connection "upgrade";<br>proxy_http_version 1.1;
- Go 服务端不要自己解析
Upgrade请求——用upgrader.Upgrade()，别手写状态码 101 - 如果本地测试跳过 Nginx，直接 curl 测试连通性：
curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" http://localhost:8080/logstream，看是否返回101 Switching Protocols
日志行实时推送但前端收不到：read deadlocks 或 write deadline exceeded
WebSocket 连接是双向的，但日志监控场景下，服务端基本只写不读。如果不做任何读操作，gorilla/websocket 的底层 conn 可能因 TCP Keepalive 或中间设备超时被静默断开，而 Go 端没感知，后续 WriteMessage 就卡住或报 write deadline exceeded。
- 必须启用 Ping/Pong 心跳：
upgrader.CheckOrigin = func(r *http.Request) bool { return true }+ 在连接后启动 goroutine 调用conn.SetPingHandler(...)和conn.SetPongHandler(...) - 每次
WriteMessage前检查连接状态：if conn == nil || conn.CloseCode() != 0，避免往已关闭连接写 - 日志源如果是文件，别用
os.Open后bufio.Scanner循环阻塞读——改用tail -f类逻辑：os.OpenFile+Seek(0, io.SeekEnd)+ 持续ReadLine+time.Sleep(100 * time.Millisecond)防空转
多个浏览器标签页同时连接导致日志重复推送
每个 WebSocket 连接都是独立的，但后端若把日志源（比如一个 *os.File）全局共享又没加同步，多个 goroutine 并发调用 ReadLine 就会跳行、漏行、甚至 panic。
立即学习“go语言免费学习笔记（深入）”；
- 不要让多个连接共用同一个文件读取器；改用「中心日志分发器」模式：一个 goroutine 读文件 → 写入
chan string→ 其他连接 goroutine 从该 channel 读 - channel 缓冲区大小设为 128 或 256 即可，太大容易积压；太小会导致写入阻塞，影响日志实时性
- 注意 channel 关闭时机：文件读到 EOF 不代表结束（日志文件可能被 logrotate），应监听
SIGHUP或定期os.Stat检查 inode 是否变化，重新打开文件
前端用 WebSocket 接收日志但换行丢失、中文乱码
Go 后端默认用 WriteMessage(websocket.TextMessage, []byte(line)) 发送，看起来没问题，但浏览器接收后 event.data 是字符串，若日志行本身不含 \n，前端拼接显示时就无法换行。
- 后端发送前确保每行末尾带
\n：conn.WriteMessage(websocket.TextMessage, append([]byte(line), '\n')) - 前端不要直接
el.innerText = data，改用el.innerHTML += data.replace(/\n/g, '<br>')
，否则换行符被忽略 - 中文正常，但若日志文件是 GBK 编码（Windows 环境常见），Go 默认按 UTF-8 解码会出错；此时需用
golang.org/x/text/encoding/charmap显式解码，别依赖系统 locale
最麻烦的不是写通，而是日志滚动时的边界情况：文件重命名、权限变更、磁盘满导致 write block —— 这些不会立刻报错，但会让连接卡住几秒甚至几分钟。得在读日志 goroutine 里加 select { case 主动探测活跃性。
