centos js日志常见问题及解决

CentOS环境下 JS 日志常见问题与解决

一 常见场景与症状

• Node.js 服务日志
  • 症状：进程异常退出、接口超时、启动失败、内存占用飙升。
  • 线索：systemd 日志中出现未捕获异常、未处理的 Promise rejection、端口被占用、依赖缺失等。
• 前端/浏览器 JS 日志
  • 症状：页面白屏、脚本报错、交互卡顿、资源加载失败。
  • 线索：Console 报错含文件名:行号:列号，网络请求失败（404/500/CORS），长任务阻塞主线程。
• Web 服务器访问/错误日志
  • 症状：接口返回 5xx、静态资源 404、反向代理异常。
  • 线索：Nginx access.log/error.log、Apache error_log 中的请求路径、状态码、上游响应时间、Header 信息。

二 快速定位与排查步骤

• 确认日志来源与路径
  • 明确是Node.js 应用日志、浏览器 Console，还是Nginx/Apache 日志；不清楚时优先查项目配置与服务单元文件。
• 实时查看与关键字筛选
  • 系统/服务日志：journalctl -u your-nodejs-service -f；通用文件：tail -f /path/to/app.log；关键字：grep -i "error\|exception\|timeout" /path/to/*.log。
• 前端问题定位
  • 打开 Chrome DevTools：Console 看错误与堆栈；Network 看请求状态与响应；Performance 录制长任务与回流重绘。
• Node.js 问题定位
  • 检查运行时与依赖：node -v、npm ls；启动时加 --inspect 远程调试；代码中加强错误与 Promise 异常捕获并记录堆栈。
• 依赖与环境
  • 核对 Node 版本与依赖一致性；检查端口占用（ss -ltnp | grep :PORT 或 netstat -tulpen | grep :PORT）；确认环境变量、数据库/缓存连通性。
• 复现与回归
  • 在本地或测试环境按相同参数复现；修复后回归验证并观察日志是否恢复正常。

三 高频问题与对策

• 日志文件过大、磁盘告警
  • 现象：磁盘空间被占满、写入失败、检索变慢。
  • 解决：配置 logrotate 按日/大小轮转并压缩归档；保留近7–30天；对访问日志可异步写入、采样高噪声接口。
• 日志级别过低导致性能下降
  • 现象：INFO/DEBUG 过多，I/O 与 CPU 占用升高。
  • 解决：生产环境默认 WARN/ERROR；仅在排障时临时开启 DEBUG；异步或批量写入避免频繁 flush。
• 前端性能瓶颈
  • 现象：交互卡顿、长任务、页面回流重绘频繁。
  • 解决：减少频繁 DOM 操作（用 DocumentFragment 批量更新）、使用事件委托、将计算密集型任务放入 Web Worker、优化重排重绘与资源加载。
• 内存泄漏与事件监听未解绑
  • 现象：内存持续增长、GC 无法回收、页面变慢或崩溃。
  • 解决：避免全局变量滥用；组件/页面卸载时移除事件监听与清理定时器；对闭包引用进行及时置空；必要时用浏览器 Memory 面板快照对比。
• 未捕获异常与 Promise rejection
  • 现象：进程静默退出或接口偶发失败无堆栈。
  • 解决：在 Node 入口统一监听 process.on('uncaughtException')、process.on('unhandledRejection') 并记录完整堆栈与上下文，然后安全退出或降级。
• 端口冲突导致服务起不来
  • 现象：服务绑定端口失败、日志报 EADDRINUSE。
  • 解决：更换端口或释放占用进程（ss -ltnp | grep :PORT 查 PID，再 kill -9 PID）；在 systemd 服务中设置Restart=on-failure 自动恢复。

四 日志采集分析与可视化

• 集中化采集与检索
  • 使用 ELK Stack（Elasticsearch + Logstash + Kibana） 或 Splunk 收集 Node/前端/Web 服务器日志，构建索引与仪表盘，支持关键字告警与错误趋势分析。
• 结构化与解析
  • 统一日志格式（如 JSON），便于检索与聚合；对常见文本日志可用正则表达式抽取时间、级别、文件、行号与消息字段，示例：
    • 正则模式：/^(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) (\w+) (\d+) \[(.+):(\d+)\]: (.+)$/
    • 捕获组：日期时间、级别、进程ID、文件、行号、消息；可按实际格式调整。
• 实时与告警
  • 结合 journalctl -f、tail -f 与 WebSocket 实时推送前端异常到后端；在 Kibana/Splunk 配置阈值告警与异常聚类。

五 最小可行排障命令清单

• 查看服务实时日志：journalctl -u your-nodejs-service -f
• 检索关键字：grep -i "error\|exception" /var/log/your-app/*.log
• 实时跟踪文件尾部：tail -f /var/log/nginx/error.log
• 检查端口占用：ss -ltnp | grep :3000 或 netstat -tulpen | grep :3000
• 前端现场定位：打开 DevTools → Console/Network/Performance，查看报错堆栈、请求状态与长任务
• 依赖与版本：node -v、npm ls
• 结构化解析示例：grep -oE '\[([^:]+):([0-9]+)\]' app.log | head（按实际日志格式调整正则）