Error Handling in Akka Actor (with Future)

image credit to sitepoint

I have been learning Scala and Akka since last fall. As promised by many tutorials, Scala looks like Java (plus functional language like Ocaml), and Akka Actor to me, is a mechanism to deal with the concurrency in Scala.

Java is not a foreign language to me, neither is concurrency programming. Still, I have to say the learning curve of Akka Actor is not smooth. Among features (or hiccups) that surpised me, error handling is top on the list.

All code in this post are also in my git repo.

Look at a simple actor below:

# ThrowExceptionActor.scala

Then we ask this actor in our main class like this:

# Main_exception.scala

In Success case, it should give us 1.


What if the operation in above actor actually throws some exception ?

Say like this ?

# ThrowExceptionActor.scala

I would expect this exception take us to case Failurein main, and the ex get print out nicely.

But… nope.

So the exception stack trace does get print out on console. The exception we receive inside case Failure in main, however, is not what we throw, but some time-out one:

akka.pattern.AskTimeoutException: Ask timed out on [Actor[akka://Sys/user/throwExceptionActor#259865281]] after [5000 ms]. Message of type []. A typical reason for `AskTimeoutException` is that the recipient actor didn’t send a reply.

What ?


How about Future ? Let’s throw some exception inside a Future:


Run it.


And… it doesn’t even print out original stack trace at all, just the same stupid time-out error.

The behavior above actually documented in Akka Actor doc.


To complete the with an exception you need to send an message to the sender. This is not done automatically when an actor throws an exception while processing a message.

So what to do ?

If an actor throw exception while processing a message, it actually restart itself. With that in mind, we could create a trait where every time the actor restart, we send throwable to sender like below:

# FailurePropatingActor.scala

Use it to create out actor.

# ThrowExceptionActorWithErrorHandling.scala

And it works great for exception throw directly from actor:

This time, we actually get the exception we throw. 👍


However, this won’t work if the exception is throw from inside a Future. In fact, once we are inside the future, old context is gone (sender is no longer valid), actor will move on to the next message, it doesn’t even know what happened to the future.

One way to fix it, is to pipe back the whole future to sender:


This works without using new trait FailurePropatingActor above:

Since we already create a trait FailurePropatingActorto deal with this, here is another way.

Send the failure back to actor itself, and deal with it like a message:


This should trigger the restart of actor.

Works like a charm:

We can even create a trait to do this.

# FailurePropatingActor.scala

Couple open questions though:

  1. We restart the actor everytime there is an exception, is it going to slow it down?

I guess if exception doesn’t happen often, it should be ok.

2. In reality, we might want to process the result of a future, then send the outcome to the next actor/http response/etc. If that’s the case, we still need to go through whole onComplete process:

someFuture.onComplete {
case Success(res) => { ... }
case Failure(ex) => { ... }

then the whole, sender()) pattern doesn’t make sense.

I help my team building amazing projects.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store