如何通过日志定位 Debian JS 问题

定位思路总览

• 明确问题归属：是前端浏览器 JS异常，还是后端 Node.js/服务异常，或两者联动问题。
• 先拿到“可复现的错误现场”：前端看Console/Network，后端看服务日志与系统日志。
• 用时间戳与请求标识串联前后端日志，优先定位第一现场（最先抛错处）。
• 结合错误类型（如SyntaxError/ReferenceError/TypeError/RangeError）与堆栈/行号快速缩小范围。
• 在测试环境复现并修复，回放日志确认恢复，最后补齐监控与告警。

日志位置与实时查看

• 常见日志路径与用途
  • 系统全局：/var/log/syslog
  • Web 服务器：
    • Apache：/var/log/apache2/error.log
    • Nginx：/var/log/nginx/error.log
  • 应用自有：项目目录或 /var/log//…
  • systemd 服务：journalctl -u <服务名>
• 常用查看与筛选
  • 实时跟踪：tail -f /var/log/syslog
  • 关键字过滤：grep -E ‘error|warning’ /var/log/nginx/error.log
  • 时间范围：journalctl --since “2025-12-10 10:00:00” --until “2025-12-10 11:00:00”
  • 多关键字与上下文：grep -A5 -B5 ‘ECONNREFUSED’ app.log
• 建议做法
  • 对 Node.js 使用 systemd 托管并输出到 journald，便于统一检索与轮转。
  • 为前端资源开启source map（仅开发/预发），便于线上错误映射回源码。

前端 JS 问题定位

• 浏览器开发者工具
  • Console：优先查看红色报错，关注错误类型、消息、文件名:行号、堆栈。
  • Network：按状态码筛选非 200/3xx，关注CORS、超时、资源加载失败；用 Copy as cURL 复现请求。
• 与后端联动
  • 用 请求ID/用户ID/时间 在 Nginx/应用日志中检索同一时刻记录，核对上游响应与报错上下文。
• 常见错误与线索
  • SyntaxError：语法错误，常见于打包产物或错误拼接。
  • ReferenceError：变量未声明，常见于作用域/依赖未加载。
  • TypeError：对 undefined/null 执行操作，常见于接口返回结构变化。
  • RangeError：数值越界，如数组长度为负等。

后端 Node.js 问题定位

• 服务日志与 systemd
  • 查看服务输出：journalctl -u myapp -f
  • 若写入文件，实时跟踪：tail -f /var/log/myapp/app.log
• 启动调试
  • 远程调试：node --inspect-brk server.js，在 chrome://inspect 连接调试。
  • IDE 调试：VS Code 配置 .vscode/launch.json 设置断点、观察调用栈与变量。
• 日志结构化
  • 统一格式：包含timestamp、level、msg、reqId、stack；便于 grep/awk 与 ELK 分析。
• 典型线索
  • ECONNREFUSED：目标服务未启动/端口不对/防火墙阻断。
  • UnhandledPromiseRejectionWarning/Exception：未捕获的 Promise 异常，需加 try/catch 或 .catch()。
  • MODULE_NOT_FOUND：依赖未安装或 NODE_PATH 配置问题。

高效检索与分析命令清单

• 实时看系统与应用日志
  • tail -f /var/log/syslog | grep -i ‘javascript’
  • tail -f /var/log/nginx/error.log | grep -E ‘js|javascript’
• 按时间与级别筛选
  • journalctl -u myapp --since today -p err
• 关键字与上下文
  • grep -n -C3 ‘TypeError’ /var/log/myapp/app.log
  • awk ‘/ERROR/ {print $1,$2,$NF}’ app.log | sort | uniq -c
• 多文件合并检索
  • find /var/log/myapp -name ‘*.log’ -exec grep -l ‘timeout’ {} +
• 大日志建议
  • 使用 logrotate 做按日轮转与压缩；海量日志接入 ELK/Splunk 做聚合与可视化。