Java 异常处理基本规则，Java异常处理的基本规范

看了团队中原来代码中的异常处理，心碎了一地，稍微对照阿里巴巴的异常处理规范整理了一遍，准备分享一下，Java的异常处理规范&约束。

一、运行异常的扑捉

不要捕获   Java  类库中定义的继承自 RuntimeException 的运行时异常类，如：IndexOutOfBoundsException / NullPointerException ，这类异常由程序员预检查来规避，保证程序健壮性。

正例：

 

1. if(null != obj) {

2.    //TODO

3. }

 

反例：

 

1. try {

2.    obj.method()

3. } catch(NullPointerException e){

4.   //TODO

5. }

 

二、 try-catch 作用域（现有代码出现率较高）

对大段代码进行try-catch ，这是不负责任的表现。catch 时请分清稳定代码和非稳定代码，稳定代码指的是无论如何不会出错的代码。对于非稳定代码的 catch 尽可能进行区分异常类型，再做对应的异常处理。
正例：
分块catch ，或者直接抛出相对应的异常，然后由下层细化处理。

 

1. map.put("status", 500);  

2. try{

3.    //代码省略

4.    map.put("message", "success！");  

5.    map.put("status", 200);  

6. } catch (UnknownHostException e) {

7.    //域名错误

8.    map.put("message", "请输入正确的网址");

9.    LoggerUtils.fmtError(e, "网址异常[%s]", url);

10. } catch (SocketTimeoutException e) {

11.    //超时

12.    map.put("message", "请求地址超时");

13.    LoggerUtils.fmtError(e, "请求地址超时[%s]", url);

14.  

15. } catch (Exception e) {

16.    //其他异常

17.    map.put("message", "请求出现未知异常，请重试！\r\n" + e.getMessage());

18.    LoggerUtils.fmtError(e, "请求出现未知异常，请重试！[%s]", url);

19. }

20. return map;

 

反例： 

 

1. try {

2.   //此处省略1024行代码

3. } catch(Exception e){

4.   //TODO

5. }

 

三、异常的捕捉 & 异常的处理（现有代码出现率较高）

捕获异常是为了处理它，不要捕获了却什么都不处理而抛弃之，如果不想处理它，请将该异常抛给它的调用者。最外层的业务使用者，必须处理异常，将其转化为用户可以理解的内容。

正例：

 

1. try{

2.    //代码省略

3. } catch (UnknownHostException e) {

4.    //域名错误

5.    map.put("message", "请输入正确的网址");

6.    LoggerUtils.fmtError(XXXXManager.class, e, "网址异常[%s]", url);

7. } catch (SocketTimeoutException e) {

8.    //超时

9.    map.put("message", "请求地址超时");

10.    LoggerUtils.fmtError(XXXXManager.class, e, "请求地址超时[%s]", url);

11.  

12. } catch (Exception e) {

13.    //其他异常

14.    map.put("message", "请求出现未知异常，请重试！\r\n" + e.getMessage());

15.    LoggerUtils.fmtError(XXXXManager.class, e, "请求出现未知异常，请重试！[%s]", url);

16. }

 

只为描述一下异常，继续抛出。 

 

1. try{

2.    //代码省略

3. } catch (UnknownHostException e) {

4.    throw new HNException("xxx处理失败。",e);

5. }

 

反例：

1.如下，调用者对异常没有任何感知。 

 

1. try{

2.    //代码省略

3. } catch (Exception e) {

4.    System.out.println("插入异常");

5. }

 

2.如下，调用者对异常无法定位和判断 

 

1. try{

2.    //代码省略

3. } catch (UnknownHostException e) {

4.    throw new RuntimeException("500");

5. }

 

四、异常 & 事务

1. 有 try 块放到了事务代码中，catch 异常后，如果需要回滚事务，一定要注意手动回滚事务。

2. 在有事务的代码中，catch 异常后，做描述异常等处理后，如果需要事务生效，请把异常继续抛出。

五、异常 & finally

1.如果有对IO 流和资源做操作，必须逐一关闭IO 流和资源对象（从里层到外层），有异常也要做处理。

 

try{

1.    //代码省略

2. } catch (Exception e) {

3.    throw new HNException("xxx处理失败。",e);

4.  

5. }finally{

6.            

7.    try {

8.        if(null != conn){

9.            conn.disconnect();

10.        }

11.    } catch (Exception e1) {

12.        LoggerUtils.fmtInfo("请求完毕关闭流出现异常！[%s]", url);

13.    }

14.    try {

15.        if(null != outStream){

16.            outStream.close();

17.        }

18.    } catch (Exception e2) {

19.        LoggerUtils.fmtInfo("请求完毕关闭流出现异常！[%s]", url);

20.    }

21.    try {

22.        if(null != out){

23.            out.close();

24.        }

25.    } catch (Exception e3) {

26.        LoggerUtils.fmtInfo("请求完毕关闭流出现异常！[%s]", url);

27.    }

28.            

29. }

 

  JDK  7 以上可以使用try-with-resources 方式。 

六、finally &  return

不能在 finally 块中使用 return ，finally 块中的 return 返回后方法结束执行，不会再执行 try 块中的 return 语句。 

七、异常需要精确

捕获异常与抛异常，必须是完全匹配，或者捕获异常是抛异常的父类。如果预期对方抛的是绣球，实际接到的是铅球，就会产生意外情况。

八、程序员的基本修养 & NPE（现有代码中出现率较高）

1.方法（接口）的返回值可以为 null ，但不推荐返回空集合，或者空对象等，必须添加注释充分说明什么情况下会返回 null 值。调用方需要进行 null 判断防止 NPE 问题。

2. 防止 NPE ，是程序员的基本修养，注意 NPE 产生的场景。

    a.查询数据库返回null ，包括null 对象和null 集合。

    b.集合内元素有null 对象。