1. 在Finally塊中清理資源或者使用try-with-resource語句

當使用類似InputStream這種需要使用后關閉的資源時，一個常見的錯誤就是在try塊的最后關閉資源。

public void doNotCloseResourceInTry() {
    FileInputStream inputStream = null;
    try {
        File file = new File("./tmp.txt");
        inputStream = new FileInputStream(file);
        // use the inputStream to read a file
        // do NOT do this
        inputStream.close();
    } catch (FileNotFoundException e) {
        log.error(e);
    } catch (IOException e) {
        log.error(e);
    }
}

上述代碼在沒有任何exception的時候運行是沒有問題的。但是當try塊中的語句拋出異常或者自己實現的代碼拋出異常，那么就不會執行最后的關閉語句，從而資源也無法釋放。

合理的做法則是將所有清理的代碼都放到finally塊中或者使用try-with-resource語句。

public void closeResourceInFinally() {
    FileInputStream inputStream = null;
    try {
        File file = new File("./tmp.txt");
        inputStream = new FileInputStream(file);
        // use the inputStream to read a file
    } catch (FileNotFoundException e) {
        log.error(e);
    } finally {
        if (inputStream != null) {
            try {
                inputStream.close();
            } catch (IOException e) {
                log.error(e);
            }
        }
    }
}

public void automaticallyCloseResource() {
    File file = new File("./tmp.txt");
    try (FileInputStream inputStream = new FileInputStream(file);) {
        // use the inputStream to read a file
    } catch (FileNotFoundException e) {
        log.error(e);
    } catch (IOException e) {
        log.error(e);
    }
}

2. 指定具體的異常

盡可能的使用最具體的異常來聲明方法，這樣才能使得代碼更容易理解。

public void doNotDoThis() throws Exception {
    ...
}
public void doThis() throws NumberFormatException {
    ...
}

如上，NumberFormatException字面上即可以看出是數字格式化錯誤。

3. 對異常進行文檔說明

當在方法上聲明拋出異常時，也需要進行文檔說明。和前面的一點一樣，都是為了給調用者提供盡可能多的信息，從而可以更好地避免/處理異常。異常處理的 10 個最佳實踐，這篇也推薦看下。

在Javadoc中加入throws聲明，并且描述拋出異常的場景。

/**
 * This method does something extremely useful ...
 *
 * @param input
 * @throws MyBusinessException if ... happens
 */
public void doSomething(String input) throws MyBusinessException {
    ...
}

4. 拋出異常的時候包含描述信息

在拋出異常時，需要盡可能精確地描述問題和相關信息，這樣無論是打印到日志中還是監控工具中，都能夠更容易被人閱讀，從而可以更好地定位具體錯誤信息、錯誤的嚴重程度等。

但這里并不是說要對錯誤信息長篇大論，因為本來Exception的類名就能夠反映錯誤的原因，因此只需要用一到兩句話描述即可。

try {
    new Long("xyz");
} catch (NumberFormatException e) {
    log.error(e);
}

NumberFormatException即告訴了這個異常是格式化錯誤，異常的額外信息只需要提供這個錯誤字符串即可。當異常的名稱不夠明顯的時候，則需要提供盡可能具體的錯誤信息。

5. 首先捕獲最具體的異常

現在很多IDE都能智能提示這個最佳實踐，當你試圖首先捕獲最籠統的異常時，會提示不能達到的代碼。當有多個catch塊中，按照捕獲順序只有第一個匹配到的catch塊才能執行。因此，如果先捕獲IllegalArgumentException，那么則無法運行到對NumberFormatException的捕獲。

public void catchMostSpecificExceptionFirst() {
    try {
        doSomething("A message");
    } catch (NumberFormatException e) {
        log.error(e);
    } catch (IllegalArgumentException e) {
        log.error(e)
    }
}

6. 不要捕獲Throwable

Throwable是所有異常和錯誤的父類。你可以在catch語句中捕獲，但是永遠不要這么做。如果catch了throwable，那么不僅僅會捕獲所有exception，還會捕獲error。而error是表明無法恢復的jvm錯誤。因此除非絕對肯定能夠處理或者被要求處理error，不要捕獲throwable。

public void doNotCatchThrowable() {
    try {
        // do something
    } catch (Throwable t) {
        // don't do this!
    }
}

7. 不要忽略異常

很多時候，開發者很有自信不會拋出異常，因此寫了一個catch塊，但是沒有做任何處理或者記錄日志。

public void doNotIgnoreExceptions() {
    try {
        // do something
    } catch (NumberFormatException e) {
        // this will never happen
    }
}

但現實是經常會出現無法預料的異常或者無法確定這里的代碼未來是不是會改動(刪除了阻止異常拋出的代碼)，而此時由于異常被捕獲，使得無法拿到足夠的錯誤信息來定位問題。合理的做法是至少要記錄異常的信息。

public void logAnException() {
    try {
        // do something
    } catch (NumberFormatException e) {
        log.error("This should never happen: " + e);
    }
}

8. 不要記錄并拋出異常

可以發現很多代碼甚至類庫中都會有捕獲異常、記錄日志并再次拋出的邏輯。如下：

try {
    new Long("xyz");
} catch (NumberFormatException e) {
    log.error(e);
    throw e;
}

這個處理邏輯看著是合理的。但這經常會給同一個異常輸出多條日志。如下：

17:44:28,945 ERROR TestExceptionHandling:65 - java.lang.NumberFormatException: For input string: "xyz"
Exception in thread "main" java.lang.NumberFormatException: For input string: "xyz"
at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
at java.lang.Long.parseLong(Long.java:589)
at java.lang.Long.(Long.java:965)
at com.stackify.example.TestExceptionHandling.logAndThrowException(TestExceptionHandling.java:63)
at com.stackify.example.TestExceptionHandling.main(TestExceptionHandling.java:58)

如上所示，后面的日志也沒有附加更有用的信息。如果想要提供更加有用的信息，那么可以將異常包裝為自定義異常。

public void wrapException(String input) throws MyBusinessException {
    try {
        // do something
    } catch (NumberFormatException e) {
        throw new MyBusinessException("A message that describes the error.", e);
    }
}

因此，僅僅當想要處理異常時才去捕獲，否則只需要在方法簽名中聲明讓調用者去處理。

9. 包裝異常時不要拋棄原始的異常

捕獲標準異常并包裝為自定義異常是一個很常見的做法。這樣可以添加更為具體的異常信息并能夠做針對的異常處理。

需要注意的是，包裝異常時，一定要把原始的異常設置為cause(Exception有構造方法可以傳入cause)。否則，丟失了原始的異常信息會讓錯誤的分析變得困難。

public void wrapException(String input) throws MyBusinessException {
    try {
        // do something
    } catch (NumberFormatException e) {
        throw new MyBusinessException("A message that describes the error.", e);
    }
}