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

node app.js > app.log 2>&1
这里的>是把标准输出重定向到app.log,而2>&1则是把标准错误输出也合并到标准输出,这样一来,所有的日志信息都会被集中保存到同一个文件里,方便后续查看。
2. 使用命令行工具筛选错误日志
对于已经保存的日志文件,比如刚才那个app.log,用几个经典的命令行工具就能快速找到想要的错误信息:
- 用
grep筛选错误关键字:grep 'Error' app.log # 查找包含"Error"的行 grep -i 'error' app.log # 忽略大小写查找 - 筛选HTTP错误状态码:
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"的行,效率非常高。
3. 通过系统日志查看(若应用作为服务运行)
如果你的Node.js应用是以系统服务的形式运行的,比如使用了systemd,那就可以通过journalctl命令来查看关联的日志:
sudo journalctl -u your-node-service.service
# 替换为你的服务名称
举个例子,如果服务名称是node-app.service,那命令就是sudo journalctl -u node-app.service。这个命令会显示出该服务的所有日志,包括各种错误的详细信息。
4. 使用日志管理库增强日志功能
想要更高效地管理错误日志,推荐使用像Winston这样的第三方日志库。它能帮你把错误日志单独保存到指定文件,排查问题时思路会清晰很多:
- 安装Winston:
npm install winston - 在应用代码中配置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文件,不会再和其他普通日志混在一起,定位问题自然更高效。
5. 常见错误码含义(辅助排查)
日志中那些看起来有点吓人的错误代码,比如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这类工具。但基础排查的功夫,命令行和日志库就能搞定。


































