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）帮助提前发现网络异常与性能退化。