一、尽量不要使用 e.printStackTrace(),而是使用 log 打印。
反例:
try {
// do what you want
} catch (Exception e) {
e.printStackTrace();
}
复制代码
正例:
try {
// do what you want
} catch (Exception e) {
log.info("你的程序有异常啦,{}", e);
}
复制代码
理由:
printStackTrace()打印出的堆栈日志跟业务代码日志是交错混合在一起的,排查异常日志不太方便。
e.printStackTrace()语句产生的字符串记录的是堆栈信息,如果信息太长太多,字符串常量池所在的内存块没有空间了,即内存满了。
二、catch 了异常,但是没有打印出具体的 exception,无法更好定位问题
反例:
try {
// do what you want
} catch (Exception e) {
log.info("你的程序有异常啦");
}
复制代码
正例:
try {
// do what you want
} catch (Exception e) {
log.info("你的程序有异常啦,{}", e);
}
复制代码
理由:
三、不要用一个 Exception 捕捉所有可能的异常
反例:
public void test () {
try {
// 抛出 IOException 的代码调用
// 抛出 SQLException 的代码调用
} catch (Exception e) {
// 用基类 Exception 捕捉的所有可能的异常,如果多个层次都这样捕捉,会丢失原始异常的有效信息哦
log.info("Exception in test, exception:{}", e);
}
}
复制代码
正例:
public void test () {
try {
// 抛出 IOException 的代码调用
// 抛出 SQLException 的代码调用
} catch (IOException e) {
// 仅仅捕捉 IOException
log.info("IOException in test,exception:{}", e);
} catch (SQLException e) {
// 仅仅捕捉 SQLException
log.info("SQLException in test,exception:{}", e);
}
}
复制代码
理由:
四、记得使用 finally 关闭流资源或者直接使用 try-with-resource
反例:
FileInputStream fdIn;
try {
fdIn = new FileInputStream(new File("/test.txt"));
//在这里关闭流资源?有没有问题呢?如果发生异常了呢?
fdIn.close();
} catch (FileNotFoundException e) {
log.error(e);
} catch (IOException e) {
log.error(e);
}
复制代码
正例 1:
需要使用 finally 关闭流资源,如下
FileInputStream fdIn = null;
try {
fdIn = new FileInputStream(new File("/test.txt"));
} catch (FileNotFoundException e) {
log.error(e);
} catch (IOException e) {
log.error(e);
} finally {
try {
if (fdIn != null) {
fdIn.close();
}
} catch (IOException e) {
log.error(e);
}
}
复制代码
正例 2:
当然,也可以使用 JDK7 的新特性 try-with-resource 来处理,它是 Java7 提供的一个新功能,它用于自动资源管理。
try (FileInputStream inputStream = new FileInputStream(new File("test.txt")) {
// use resources
} catch(FileNotFoundException e) {
log.error(e);
} catch (IOException e) {
log.error(e);
}
复制代码
理由:
五、捕获异常与抛出异常必须是完全匹配,或者捕获异常是抛异常的父类
反例:
// BizException 是 Exception 的子类
public class BizException extends Exception {}
// 抛出父类Exception
public static void test() throws Exception {}
try {
// 编译错误
test();
} catch (BizException e) {
// 捕获异常子类是没法匹配的
log.error(e);
}
复制代码
正例:
//抛出子类Exception
public static void test() throws BizException {}
try {
test();
} catch (Exception e) {
log.error(e);
}
复制代码
六、捕获到的异常,不能忽略它,至少打点日志吧
反例:
public static void testIgnoreException() throws Exception {
try {
// 搞事情
} catch (Exception e) {
}
}
复制代码
正例:
public static void testIgnoreException () {
try {
// 搞事情
} catch (Exception e) {
log.error("这个异常不应该在这里出现的,{}", e);
}
}
复制代码
理由:
七、注意异常对你的代码层次结构的侵染(早发现早处理)
反例:
public UserInfo queryUserInfoByUserId(Long userid) throw SQLException {
// 根据用户Id查询数据库
}
复制代码
正例:
public UserInfo queryUserInfoByUserId(Long userid) {
try {
//根据用户Id查询数据库
} catch (SQLException e) {
log.error("查询数据库异常啦,{}", e);
} finally {
//关闭连接,清理资源
}
}
复制代码
理由:
八、自定义封装异常,不要丢弃原始异常的信息 Throwable cause
我们常常会想要在捕获一个异常后抛出另一个异常,并且希望把原始异常的信息保存下来,这被称为异常链。公司的框架提供统一异常处理就用到异常链,我们自定义封装异常,不要丢弃原始异常的信息,否则排查问题就头疼啦
反例:
public class TestChainException {
public void readFile() throws MyException {
try {
InputStream is = new FileInputStream("test.txt");
Scanner in = new Scanner(is);
while (in.hasNext()) {
System.out.println(in.next());
}
} catch (FileNotFoundException e) {
//e 保存异常信息
throw new MyException("文件在哪里呢");
}
}
public void invokeReadFile() throws MyException {
try {
readFile();
} catch (MyException e) {
//e 保存异常信息
throw new MyException("文件找不到");
}
}
public static void main(String[] args) {
TestChainException t = new TestChainException();
try {
t.invokeReadFile();
} catch (MyException e) {
e.printStackTrace();
}
}
}
//MyException 构造器
public MyException(String message) {
super(message);
}
复制代码
正例:
public class TestChainException {
public void readFile() throws MyException {
try {
InputStream is = new FileInputStream("test.txt");
Scanner in = new Scanner(is);
while (in.hasNext()) {
System.out.println(in.next());
}
} catch (FileNotFoundException e) {
//e 保存异常信息
throw new MyException("文件在哪里呢", e);
}
}
public void invokeReadFile() throws MyException {
try {
readFile();
} catch (MyException e) {
//e 保存异常信息
throw new MyException("文件找不到", e);
}
}
public static void main(String[] args) {
TestChainException t = new TestChainException();
try {
t.invokeReadFile();
} catch (MyException e) {
e.printStackTrace();
}
}
}
//MyException 构造器
public MyException(String message, Throwable cause) {
super(message, cause);
}
复制代码
九、运行时异常 RuntimeException ,不应该通过 catch 的方式来处理,而是先预检查,比如:NullPointerException 处理
反例:
try {
obj.method()
} catch (NullPointerException e) {
}
复制代码
正例:
十、注意异常匹配的顺序,优先捕获具体的异常
注意异常的匹配顺序,因为只有第一个匹配到异常的 catch 块才会被执行。如果你希望看到,是 NumberFormatException 异常,就抛出 NumberFormatException,如果是 IllegalArgumentException 就抛出 IllegalArgumentException。
反例:
try {
doSomething("test exception");
} catch (IllegalArgumentException e) {
log.error(e);
} catch (NumberFormatException e) {
log.error(e);
}
复制代码
正例:
try {
doSomething("test exception");
} catch (NumberFormatException e) {
log.error(e);
} catch (IllegalArgumentException e) {
log.error(e);
}
复制代码
理由:因为 NumberFormatException 是 IllegalArgumentException 的子类,反例中,不管是哪个异常,都会匹配到 IllegalArgumentException,就不会再往下执行啦,因此不知道是否是 NumberFormatException。所以需要优先捕获具体的异常,把 NumberFormatException 放前面。
评论