发布于2026-06-10 阅读(0)
扫一扫,手机访问
在Ubuntu环境下排查Node.js应用的问题,最直接的就是先搞清楚错误日志怎么看。不少人一看到终端里红色的报错就慌,其实只要掌握几个基本方法,大多数问题都能快速定位。下面直接进入正题。
如果你的Node.js应用是在前台运行的,比如直接敲了node app.js,那么错误信息会直接打印到终端上。通常这些信息以Error:为前缀,或者包含像404、500这样的HTTP状态码。如果想要长期保留这些日志,把输出重定向到文件是最简单的办法:

node app.js > app.log 2>&1
这里的>是把标准输出重定向到app.log,而2>&1则是把标准错误输出也合并到标准输出,这样一来,所有的日志信息都会被集中保存到同一个文件里,方便后续查看。
对于已经保存的日志文件,比如刚才那个app.log,用几个经典的命令行工具就能快速找到想要的错误信息:
grep筛选错误关键字:grep 'Error' app.log
# 查找包含"Error"的行
grep -i 'error' app.log # 忽略大小写查找
grep -E '4[0-9]{2}|5[0-9]{2}' app.log
# 查找4xx(客户端错误)或5xx(服务器错误)
tail -f app.log # 实时显示日志文件末尾内容,按Ctrl+C退出
这些命令还可以组合使用,比如tail -f app.log | grep 'Error'就能在实时监控的同时,只显示包含"Error"的行,效率非常高。
如果你的Node.js应用是以系统服务的形式运行的,比如使用了systemd,那就可以通过journalctl命令来查看关联的日志:
sudo journalctl -u your-node-service.service
# 替换为你的服务名称
举个例子,如果服务名称是node-app.service,那命令就是sudo journalctl -u node-app.service。这个命令会显示出该服务的所有日志,包括各种错误的详细信息。
想要更高效地管理错误日志,推荐使用像Winston这样的第三方日志库。它能帮你把错误日志单独保存到指定文件,排查问题时思路会清晰很多:
npm install winston
const winston = require('winston');
const logger = winston.createLogger({
level: 'info',
format: winston.format.json(),
transports: [
new winston.transports.File({ filename: 'error.log', level: 'error' }), // 仅保存错误日志
new winston.transports.File({ filename: 'combined.log' }) // 保存所有日志
]
});
// 示例:记录错误日志
logger.error('This is an error message', { stack: new Error().stack });
配置好之后,错误日志会被单独写入error.log文件,不会再和其他普通日志混在一起,定位问题自然更高效。
日志中那些看起来有点吓人的错误代码,比如EADDRINUSE、ENOENT,其实是解决问题的关键线索。下面列举一些最常见的:
EADDRINUSE:端口被占用了。比如看到Error: listen EADDRINUSE :::3000,可以用lsof -i :3000查看是哪个进程占用了端口,再用kill -9 终止它。ENOENT:文件或目录不存在。比如Error: ENOENT: no such file or directory, open '/path/to/file',这时候只需要检查一下路径是否正确。EACCES:权限不足。比如Error: EACCES: permission denied, open '/var/log/node.log',可以用chmod 644 /var/log/node.log修改文件权限。ECONNREFUSED:连接被拒绝。比如Error: connect ECONNREFUSED 127.0.0.1:8080,需要确认目标服务是否已经启动,或者检查防火墙设置和URL。ETIMEDOUT:操作超时。比如Error: connect ETIMEDOUT 192.168.1.1:80,可以检查网络连接,或者适当增加超时时间,比如在axios中配置timeout。掌握以上这些方法,日常排查Node.js应用的问题基本够用了。如果业务规模上来了,需要更高级的日志分析,比如可视化,可以再考虑整合ELK Stack、Graylog这类工具。但基础排查的功夫,命令行和日志库就能搞定。
上一篇:怎样修改Apache默认端口
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
正版软件
正版软件
正版软件
正版软件
正版软件
1
2
3
7
8