I do believe that the docs for Dancer2 send_file are more "wishlist" or "todo" than "this is how it works", this is based of my reading of send_file and Dancer2::Handler::File

send the bug upstream :)