Fixing a “Too many open files” exception

One of the many components of which Codacy is comprised started displaying, from time to time, a “Too many open files” exception. This was one of the hardest bug we’ve had to face to date, getting us to the point of pulling out our hair. Today, were sharing how we fixed it so that you can avoid pulling out yours.

Close opened resources

The go to solution when you start getting this kind of exceptions is to look for resources like files, sockets, etc that weren’t properly closed.

In our code, we follow the golden rule of closing whatever we open, but still, there we’re some details of our Scala + PlayFramework stack, that we were unaware that caused leaking of resources.


Although the method is often used in oneliners and seductive to use in a functional style, it does not close the file opened unless you do it explicitly.

val source ="file.txt")
val lines = try { source.mkString } finally { source.close() }


This is another sneaky one. If you’re using play-ws outside a play application, and you’re creating an instance of NingWSClient and casting it to WSClient, you’ll care about this case. Previous to version 2.4, the WSClient interface didn’t exposed a close method, so one would assume that it is managed automatically. Wrong, the file descriptor was left open. To close it you should cast the client to NingWSClient as:


In newer versions than 2.4, the method is exposed in the WSClient interface.

Increasing the system limits

If you got this far, maybe you’re starting to feel let down. You’ve done everything right, but still your application is crashing. Don’t worry, it’s normal. Some applications just have to handle more files than what OS defaults are set. The rest of the guide is for specific for an Ubuntu stack.


The system limits for open file descriptors are set in /etc/security/limits.conf. You can change those by editing the file or by running:

ulimit -Hn 65536
ulimit -Sn 65536

You can now check if the limits were applied to your play application by running:

In case it didn’t maybe you’re missing this line in the file /etc/pam.d/common-session:

session required

System services

If after these changes your app is still using the original limits, you may be running it as a service. Our app was being initialised with an initscript which doesn’t honor the limits set in /etc/security/limits.conf. In order to get it working we had to hardcode the limits in the init script.

At last, success! It was a very hard debugging session that spawn over a couple of days. I have to thank to my debugging buddy, the rubber duckling, who keep me sane during this journey.

Edit: We just published an ebook: “The Ultimate Guide to Code Review” based on a survey of 680+ developers. Enjoy!


About Codacy

Codacy is used by thousands of developers to analyze billions of lines of code every day!

Getting started is easy – and free! Just use your  GitHub, Bitbucket or Google account to sign up.


Software Development

Related Articles