第一次写 node 项目,之前除了前端的脚手架构建接触过一些简单的,所以总是碰到很多坑。比如权限验证,比如异常处理,比如日志管理。
在看 log4js 使用方法的时候突然想到自己就可以实现简单的业务,不需要借助组件,虽然简单但是实现了挺开心的。
为什么需要日志管理
自己的 node 项目写了一段时间了,但一直没有加上日志管理的功能,因为觉得没必要,很多时候都是在自己电脑上面调试的。
但突然有一天在线上访问自己的项目,发现页面报错了,想知道为什么报错了,发现竟然没有什么很好的方法,如果我没有通过一个东西去记录的话,所以日志管理这个时候就显得尤为重要了。
日志的产生过程
- 页面出现错误
- 根据错误类型创建日志文件
- 写入错误信息
创建日志方法的实现
- 先判断要写入的路径是否存在,不存在则创建
- 判断日志要创建在的文件夹存不存在,不存在则创建
- 判断当前要创建的日志存不存在,存在继续写入,不存在则创建并写入
fs.stat
检查路径是否存在
fs.mkdir
创建目录的方法
fs.readFile
读取文件的方法
fs.writeFile
写入文件的方法
完成的写入日志函数
我的业务是定义了两个类型,错误和 sql,然后传入日志内容
/**
* 写入日志
* @param {String} type // 日志类型 err 错误日志 sql sql 日志
* @param {String} content
*/
writeLog (content, type = 'err') {
// 创建不存在的文件夹
await this.dirExists(`log/file/${type}`)
// 获取到文件 files
fs.readFile(`log/file/${type}/${utils.switchTime(new Date(), 'YYYY-MM-DD')}.log`, (err, data) => {if (err) {console.log(err)
}
// 写入文件
fs.writeFile(`log/file/${type}/${utils.switchTime(new Date(), 'YYYY-MM-DD')}.log`, `${data || ''}\n${content}`, async (err) => {if (err) {console.log(err)
}
})
})
}
使用
在 sql 执行函数上使用
function query (sql) {
// 写入 sql
NodeLog.writeLog(sql, 'sql')
return new Promise((resolve, reject) => {pool.getConnection((err, conn) => {if (err) {
// 如果是连接断开,自动重新连接
if (err.code === 'PROTOCOL_CONNECTION_LOST') {setTimeout(query(), 2000);
reject('断开重连');
} else {console.error(err.stack || err);
reject(err);
}
} else {
// 得到结果
conn.query(sql, (queryErr, result) => {if (queryErr) {reject(queryErr);
} else {resolve(result);
}
// 释放连接
conn.release();})
}
})
})
}
在异常处理函数中使用
handleException (req, res, e) {
// 写入日志
NodeLog.writeLog(e)
res.json({
code: e.errno || 20501,
success: false,
content: e,
message: '服务器内部错误'
})
}
最后
日志完整代码
node 项目
对应的前端项目