Ubuntu JS日志中网络问题如何定位

Ubuntu 环境下定位 JS 网络问题的实用流程

一 明确问题边界与日志入口

• 区分问题发生在前端 JS（浏览器）还是后端 Node.js（服务器），两类日志入口不同。
• 前端优先打开浏览器开发者工具：按 F12，在 Console 查看运行时报错，在 Network 检查请求状态、响应码、耗时与跨域提示。
• 后端查看服务日志：若用 PM2 管理，执行 pm2 logs；若以 systemd 托管，执行 journalctl -u your-service-name -f 实时跟踪；同时关注应用自身日志文件与应用安装目录或用户目录下的日志。
• 系统层面同步观察 /var/log/syslog、/var/log/kern.log、/var/log/dmesg 以捕捉内核与系统网络事件。

二 从系统日志快速定位网络线索

• 实时查看系统日志：
  • 系统级：sudo tail -f /var/log/syslog
  • 内核与驱动：/var/log/kern.log、/var/log/dmesg
• 若 JS 运行在容器中，同时检查容器运行时日志（如 Docker：docker logs < 容器名> ）。
• 使用 grep 过滤关键字加速定位，例如：
  • grep ‘error|timeout|ECONNREFUSED|ETIMEDOUT’ /var/log/syslog
  • grep ‘your-app’ /var/log/syslog
• 这些日志可帮助发现网络接口变化、驱动加载、连接拒绝、超时等系统侧线索。

三 用网络工具验证连通性与路由

• 基础连通性：
  • ping -c 4 example.com（检测 ICMP 可达性）
  • nslookup 或 dig example.com（验证 DNS 解析）
• 路由路径与质量：
  • traceroute example.com 或 mtr example.com（定位延迟与丢包节点）
• 端口与服务可达性：
  • nc -vz 或 telnet （测试目标端口是否开放）
• 本机监听与连接状态：
  • ss -tulpen | grep 或 netstat -tulpen | grep （确认服务是否在期望 IP/端口 监听）
• 抓包分析（必要时）：
  • sudo tcpdump -i any -n port 443 or port 80（抓取 HTTP/HTTPS 流量，进一步确认握手与丢包）
• 若涉及外部依赖（数据库、缓存、第三方 API），对其主机也执行上述连通性与端口测试。

四 结合 Node.js 与应用日志锁定根因

• 增强日志可观测性：在 Node.js 中使用 Winston、Morgan、Pino 等记录请求与错误，并在异常分支打印关键上下文（如 url、method、statusCode、headers、remoteAddress、堆栈）。
• 典型错误与日志特征对照：
  • ENOTFOUND / EAI_AGAIN：DNS 解析失败，检查 /etc/resolv.conf、DNS 服务器与 nslookup/dig 结果。
  • ECONNREFUSED：目标主机端口未监听或被拒绝，使用 nc/telnet 与远端服务状态核对。
  • ETIMEDOUT：连接或读写超时，结合 ping/mtr/tcpdump 判断是链路延迟、丢包还是远端处理慢。
  • EADDRINUSE：端口被占用，检查 ss/netstat 与进程占用并释放端口。
  • EACCES：权限不足（常见于低编号端口或防火墙/SELinux 策略），检查服务账户与策略。
• 若使用 PM2，用 pm2 logs 实时查看并配合 –time 输出时间戳，便于与系统日志对齐。

五 策略与配置层面的检查与优化

• 防火墙与安全组：
  • sudo ufw status（查看 UFW 规则）
  • 必要时检查 iptables 或云厂商安全组是否放行应用端口与依赖端口。
• 网络配置：
  • ip a 检查网卡与 IP 分配；ip route 检查默认网关；必要时 sudo dhclient 重新获取地址；sudo ip link set up 启用网卡。
  • /etc/resolv.conf 或 nmcli 调整 DNS 服务器。
• 运行与依赖：
  • node -v 确认 Node.js 版本与依赖一致；必要时升级或回退版本。
• 可观测性建设：
  • 集中式日志（如 ELK/Graylog/Splunk）与监控告警（如 Prometheus/Grafana）帮助提前发现网络异常与性能退化。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！