Ubuntu JS日志错误如何解决

Ubuntu 环境下 JavaScript 日志错误的定位与修复

一、快速定位路径

• 先判断是前端 JS（浏览器侧）还是Node.js（服务端）问题：前端看浏览器开发者工具 Console；Node.js 看服务日志与系统日志。
• 查看服务日志：若以 systemd 管理，执行：sudo journalctl -u your-service-name -f；实时跟踪日志：tail -f /var/log/your-app.log。
• 系统级与反向代理日志：/var/log/syslog、/var/log/nginx/error.log、/var/log/apache2/error.log。
• 前端问题：在浏览器按 F12 → Console 查看错误与堆栈；必要时查看 Network 确认请求状态与响应。
• 辅助工具：grep "ERROR" /var/log/syslog、less/awk/sed 做关键字与字段筛选。

二、常见错误与修复对照表

三、高频场景的处置步骤

• 前端 JS 报错
  1. 打开浏览器开发者工具 Console 定位错误与堆栈；2) 在 Network 检查失败请求的 HTTP 状态码、响应与 CORS；3) 本地复现后修复，必要时增加异常边界与日志。
• Node.js 服务崩溃或异常退出
  1. 用 journalctl -u your-service -f 或 tail -f 查看最新日志；2) 若为 EADDRINUSE，释放端口或改端口；3) 若为 EACCES，调整权限或以具备权限的用户运行；4) 若提示内存不足，先优化算法/依赖，再考虑 --max-old-space-size 提升堆上限；5) 修复后重启：sudo systemctl restart your-service。
• 系统资源或依赖导致的异常
  1. 资源检查：top/htop（CPU/内存）、free -m、df -h（磁盘）；2) 依赖与环境：确认 Node.js/npm 版本与 PATH、必要环境变量；3) 必要时升级依赖并重启服务。

四、日志与监控最佳实践

• 结构化与分级日志：使用 Winston/Bunyan/Pino 输出 JSON 并区分 ERROR/WARN/INFO，便于检索与聚合。
• 日志轮转与保留：用 logrotate 控制单文件大小与保留份数，避免磁盘被占满。
• 集中化与可视化：搭建 ELK（Elasticsearch/Logstash/Kibana）或接入 Splunk，对多实例日志统一检索、告警与看板。
• 错误追踪：接入 Sentry/Bugsnag 获取用户侧异常堆栈、版本与环境信息，加速定位。
• 持续观察：修复后继续 tail -f 观察一段时间，确认无新 ERROR/WARN 再视为恢复。

五、最小可行排错命令清单

• 实时看服务日志：sudo journalctl -u your-service -f
• 跟踪应用日志：tail -f /var/log/your-app.log
• 查端口占用：sudo lsof -i:3000 或 ss -ltnp | grep 3000
• 系统资源：top/htop、free -m、df -h
• 关键字检索：grep -i "error\|exception\|fail" /var/log/syslog | tail -50
• 重启服务：sudo systemctl restart your-service
• 前端现场定位：浏览器 F12 → Console/Network，复现并修复后清缓存再测。