Tuesday 3 May 2011

Logging is the new Exception Swallowing

For a long time now I’ve been stamping down hard on empty catch blocks in code, for obvious reasons.  When I can dictate coding standards that’s pretty much top the list. 

  1. Every ‘catch’ block must (at a minimum) log or throw

I now realise I made a mistake with this rule...it should be:

  1. Every ‘catch’ block must (at a minimum) throw or log

It’s a subtle (the wording – not the formatting) difference in the way we need to think about this rule but it’s one I think we don’t think about enough. 

For example, this is a common pattern of code that I’m seeing during Code Review sessions:

   1: public bool PerformCriticalTask()
   2: {
   3:     try
   4:     {
   5:         CriticalFunctionalityTaskA();
   6:         CriticalFunctionalityTaskB();
   7:         CriticalFunctionalityTaskC();
   8:         return true;
   9:     }
  10:     catch(Exception ex)
  11:     {
  12:         Logger.Log(ex);
  13:     }
  14:     return false;
  15: }
  16:  
  17: public CriticalFunctionalityTaskA()
  18: {
  19:     try
  20:     {
  21:         //Do Important Stuff Here
  22:     }
  23:     catch(Exception ex)
  24:     {
  25:         Logger.Log(ex);
  26:     }
  27: }
  28:  
  29: public CriticalFunctionalityTaskB()
  30: {
  31:     try
  32:     {
  33:         //Do More Important Stuff Here
  34:     }
  35:     catch(Exception ex)
  36:     {
  37:         Logger.Log(ex);
  38:     }
  39: }
  40:  
  41: public CriticalFunctionalityTaskC()
  42: {
  43:     try
  44:     {
  45:         //Do The Most Important Stuff
  46:     }
  47:     catch(Exception ex)
  48:     {
  49:         Logger.Log(ex);
  50:     }
  51: }

It’s pretty clear that this Catch/Log pattern has become a developers default exception handling boiler plate code.  It’s adding no value and actually making the troubleshooting processes more complicated and time consuming. 

My response to this is simple…remove all exception handling!

In the vast majority of cases, if an exception is thrown the application is already broken and letting it limp along is an act of cruelty.  The application should handle these critical failures as exceptional and handle all of these events the same way in an application scoped way (Custom Error Page for Web Applications, etc).  By all means log the exception at the application scope level, it will have actual diagnostic value there(complete stack trace, etc).

Of course, there are exceptions to this policy such as when you can legitimately recover from the fault.  But these cases are few and far between.

2 comments:

  1. Hear hear! Especially now with Elmah, you can get all the benefit of logging the exception, but keep your code clear of empty catches.

    My thinking is that you shouldn't catch a generic exception. If you're legitimately using try/catch, then you should have some idea of what type of exception you are expecting to catch.

    ReplyDelete
  2. Also, Exceptioneer. It's pretty simple to create a custom error handler (I've got a post on here somewhere).

    I usually find that for practical purposes, code either works or is broken. In that case an application level generic error handler is good enough.

    Of course, if you can legitimately recover from the error then it should be typed correctly.

    ReplyDelete

Got something to say? Let it out then!
Comments are moderated, so it may take a while to for them to be displayed here!