前言
最近老大让我修改项目里所有和log有关的代码,之前我也用过log4j、slf4j或者Logback等日志框架/接口,一直以为打印异常信息就是简单地一句log.info()或者log.error()而已,没想到原来一直都使用错了,以至于有些错误信息没能在log文件中打印出堆栈信息,最终难以定位bug,排查困难。
如何正确地打印异常的堆栈信息?
一般在catch到异常的时候,不要使用e.printStackTrace()来打印异常信息。我们使用日志框架来打印信息,一般来说,日志框架的log级别从低到高是:debug, info, warn, error, fatal。
对于异常,一般使用log.error()来打印堆栈信息。下边的三个log语句都打印了异常,但是写法却不一样,打印出来的效果也是不同的:
1 2 3 | log.error("ERROR", "Error found: ", e); log.error("ERROR", "Error found: " e.getMessage()); log.error("ERROR", "Error found: " e); |
---|
以下边的代码为例:
1 2 3 4 5 6 7 | try { System.out.println(1/0); } catch (final Exception e) { log.error("ERROR", "Error found: ", e); log.error("ERROR", "Error found: " e.getMessage()); log.error("ERROR", "Error found: " e); } |
---|
在log文件中可以发现输出是这样的:
1 2 3 4 5 | 2018-11-09 11:46:34,834 main ERROR com.lewis.test.TestLewis - Message: ERROR; Description: Error found: java.lang.ArithmeticException: / by zero at com.lewis.test.TestLewis.main(TestLewis.java:46) 2018-11-09 11:46:34,837 main ERROR com.lewis.test.TestLewis - Message: ERROR; Description: Error found: / by zero 2018-11-09 11:46:34,838 main ERROR com.lewis.test.TestLewis - Message: ERROR; Description: Error found: java.lang.ArithmeticException: / by zero |
---|
对于第一个log语句,可以看到堆栈信息被打印了出来。 对于第二个log语句,只是打印出了异常的具体信息,既没有异常类名,也没有堆栈信息。 对于第三个log语句,打印出了异常的类名和具体信息,但是没有打印出来堆栈信息。
总结一下,就是我们应该使用第一种log语句的形式来将堆栈信息打印出来,方便日后定位bug,排除错误。
警告
本文最后更新于 November 11, 2018,文中内容可能已过时,请谨慎使用。