Project

safe_query

0.01
No release in over a year
Helps developers avoid unsafe queries in ActiveRecord. This gem will raise an error when iterating over a relation that is potentially unpaginated.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 3.12
~> 1.6.1

Runtime

>= 5.0, < 8.0
>= 5.0, < 8.0
 Project Readme

SafeQuery

Query things in ActiveRecord safely.

Why

To prevent unbounded resource consumption, we always want to limit how many rows can be returned from database fetches.

Calls to ActiveRecord::Relation#each (without a LIMIT clause) are dangerous and should be avoided, because they can accidentally trigger an unpaginated database fetch for millions of rows, exhausting your web server or database resources.

In the worst case, this can present a denial-of-service vulnerability, so exceptions to this rule should be carefully vetted.

Worse, it's common to hit this problem only in production, because development environments seldom contain enough database rows to highlight the issue. This makes it easy to write code that seems to work well, but fails when operating on a database with more data.

This gem raises an exception whenever you attempt to call ActiveRecord::Relation#each without a limit clause, giving you the opportunity to catch and fix this before any unsafe code hits production.

How it works

With this gem installed, Rails will throw an exception when you make an unsafe query. It will attempt to highlight the query and the code that triggered it:

image

Compatibility:

  • Rails 5+
  • Ruby 2.7+
  • Postgres, MySQL, SQLite, maybe others (untested)

Installation:

Add to your gemfile:

gem 'safe_query', group: [:development, :test]

then bundle install.

It's recommended to set config.active_record.warn_on_records_fetched_greater_than (available since Rails 5), so you have warnings whenever a query is returning more rows than expected, even when using this gem. For example, if your app is never supposed to have no more than 100 records per page, add to config/environments/development.rb:

  config.active_record.warn_on_records_fetched_greater_than = 100

Example fixes:

When SafeQuery catches a problem, you will commonly want to apply one of these fixes. This list is not exhaustive, and contributions are welcome.

1) Use find_each instead

Sometimes the fix is as easy as changing

book.authors.each do |author|

to this:

book.authors.find_each do |author|

Sometimes this doesn't work:

  • For some reason you don't have an autoincrementing primary key ID for Rails to paginate on
  • You have a specific sort order and you want to maintain the sort order. find_each will sort by ID, which may not be what you want.

In those cases, you may have to add some custom code to maintain your existing app behavior. But otherwise, you can use find_each or any other solution from the ActiveRecord::Batches API.

2) Paginate your results

Use your existing pagination solution, or look at adding pagy, kaminari, will_paginate, etc to your app.

3) Add a limit clause

Sometimes you are simply missing a limit clause in your query. This might be the case if you have an implied upper bound on the number of results enforced by the application elsewhere. SafeQuery will find cases where this limit isn't expressed in your queries, which might be a problem if your enforcement logic is flawed in some way.

4) Ignore the problem

You can ignore this problem (and prevent SafeQuery from raising) by converting the relation to an array with to_a before you operate on it:

book.authors.each ...

to this:

book.authors.to_a.each ...

Obviously, you should only do this if you are sure that the number of records is bounded to a reasonable number somewhere else.

Contributing

see CONTRIBUTING.md