Ubuntu Node.js日志中网络问题如何排查

Ubuntu系统中Node.js日志里网络问题的排查步骤

1. 查看Node.js应用日志，定位具体错误

Node.js应用的日志是排查网络问题的首要线索，需重点关注错误类型和堆栈跟踪。常见网络错误及对应的日志表现包括：

• 连接超时：Error: connect ETIMEDOUT（请求未在指定时间内得到响应）；
• DNS解析失败：Error: getaddrinfo ENOTFOUND <域名>（无法将域名转换为IP地址）；
• 端口不可用：Error: listen EADDRINUSE <端口号>（端口已被其他进程占用）；
• 连接被拒绝：Error: connect ECONNREFUSED（目标服务器未监听指定端口）；
• HTTP请求失败：Error: Request failed with status code <非200状态码>（如404、500等）。

可通过grep命令快速筛选日志中的网络错误，例如：

grep -E 'ETIMEDOUT|ENOTFOUND|ECONNREFUSED|EADDRINUSE' app.log

若日志未记录详细错误，需调整日志级别（如使用winston设置为debug）或添加console.error输出错误详情。

2. 检查系统日志，获取系统级网络信息

Ubuntu的系统日志（如syslog、kern.log）会记录网络驱动、内核层面的问题，补充应用日志的不足。使用以下命令查看实时或历史系统日志：

# 实时查看系统日志（过滤Node.js相关进程）
sudo tail -f /var/log/syslog | grep node

# 查看内核网络日志（如网卡错误、路由问题）
sudo less /var/log/kern.log

重点关注与网络相关的关键词（如network error、dropped packet、failed connection）。

3. 使用网络诊断工具，验证基础网络连通性

通过命令行工具快速排查网络层问题：

• 测试连通性：ping <目标域名/IP>（如ping example.com），若未收到回复，说明网络不通；
• 追踪路由路径：traceroute <目标域名/IP>（如traceroute google.com），查看数据包经过的节点，定位延迟或丢包位置；
• 检查端口可达性：telnet <目标IP> <端口号>（如telnet example.com 80）或nc -zv <目标IP> <端口号>，若连接失败，说明端口未开放或防火墙拦截；
• 测试HTTP请求：curl -v <API地址>（如curl -v https://api.example.com/data），查看请求响应详情（如状态码、响应头）。

4. 检查防火墙设置，确保允许Node.js网络访问

Ubuntu的防火墙（如ufw）可能阻止Node.js应用的网络请求，需确认规则是否放行：

• 查看防火墙状态：sudo ufw status（若未启用，可跳过后续步骤）；
• 允许HTTP/HTTPS流量：sudo ufw allow http、sudo ufw allow https；
• 允许特定端口（如3000）：sudo ufw allow 3000/tcp；
• 重启防火墙使规则生效：sudo ufw reload。

5. 分析代码中的网络配置，修复逻辑错误

检查Node.js代码中的网络相关部分，重点关注以下几点：

• 错误处理：确保所有网络请求（如http.request、axios）都有.catch或error事件监听，避免未捕获的异常；
• 超时设置：为请求添加合理的超时时间（如axios的timeout: 5000、http模块的options.timeout），避免长时间等待；
• DNS配置：确认代码中的主机名正确，避免拼写错误（如api.example.com而非ap1.example.com）；
• 代理设置：若使用代理，需在代码中正确配置（如axios的proxy选项）。

6. 使用网络分析工具，深入排查数据包问题

若上述步骤无法定位问题，可使用Wireshark捕获网络流量，分析数据包的详细信息：

• 安装Wireshark：sudo apt install wireshark；
• 启动捕获：sudo wireshark，选择网卡（如eth0）开始捕获；
• 过滤Node.js应用的流量（如ip.addr == <目标IP>），查看是否有丢包、延迟或重传等问题。

通过以上步骤，可系统性地排查Ubuntu系统中Node.js日志里的网络问题，从应用层到系统层逐步缩小问题范围，最终定位并解决问题。