Rails 6 Band-Aid for Webpacker::Manifest::MissingEntryError

At CodeFund, we try to keep our dependencies, including Rails, as up to date as possible. We upgraded to Rails 6 a few months ago, and I've pretty much forgotten any issues we ran into during the upgrade. For what it's worth, the upgrade was very smooth, but there was one issue we ran into that was lost in my memories before a friend showed me a familiar error message today:

# Webpacker::Manifest::MissingEntryError:
#   Webpacker can't find foo/bar in /app/public/packs-test/manifest.json. Possible causes:
#   1. You want to set webpacker.yml value of compile to true for your environment
#      unless you are using the `webpack -w` or the webpack-dev-server.
#   2. webpack has not yet re-run to reflect updates.
#   3. You have misconfigured Webpacker's config/webpacker.yml file.
#   4. Your webpack configuration is not creating a manifest.
#   Your manifest contains:
#   {
#   }

The error essentially is letting you know that Webpacker tried to locate the foo/bar asset entry in the manifest.json file that gets generated when Webpacker compiles your test assets, but it could not find it. Even more interesting, the manifest is completely empty.

It is worth noting that I only ran into this issue in my test environment, which is exactly what was happening to my buddy. If your Webpacker config is close to the default, assets are precompiled into public/packs-test/*, which you an see on the second line of the error above.

An issue was created on Webpacker's GitHub repo that basically describes this scenario. It is issue #1494 if you are curious. However, all of the solutions that worked for others were not working for me, nor my friend who had also found the same issue.

At the time, I figured that we had incorrectly configured something and eventually gave up trying to find the cause and instead focused on finding a solution. It is also worth noting that we are using Minitest at CodeFund, but my friend was using Rspec, which rules out one of my earlier ideas that this could be a Minitest specific issue.

I am still not quite sure the cause, and one of my hopes for posting this article is that someone else has run across this and actually fixed the core issue instead of the band-aid I chose to go with.

If you encounter this type of error in your tests while upgrading to Rails 6, here is one way of solving it:

# test/test_helper.rb

unless Webpacker.compiler.fresh?
  puts "== Webpack compiling =="
  Webpacker.compiler.compile
  puts "== Webpack compiled =="
end

Adding this method in your test_helper or spec_helper before the tests run will force Webpacker to make sure the test-packs are present and up to date, and if not it will compile them. If you do some source diving, you will see this comment above the fresh? method in Webpacker::Compiler:

Returns true if all the compiled packs are up to date with the underlying asset files.

The reason the manifest is empty is because Webpacker needs to be compiled, because the currently compiled packs are not up to date or were never generated in the first place. Webpacker is supposed to do this automatically, but for my friend and I, it wasn’t.

You can see the usage of this in CodeFund's test_helper.rb. If you try to run the test suite and public/packs-test has not been created or the test packs are not up to date, you will see this in your terminal:

➜ bin/rails test
== Webpack compiling ==
== Webpack compiled ==

# Running tests with run options --seed 1234:

...

As to why this is happening, I am still not sure. I am still leaning towards this being caused from a misconfiguration or some behavior specific to our setup, but after being asked about it today, I figured it was worth sharing in case you run across it in your own app.

If you have run into this before and fixed the underlying cause, please leave a comment below or mention me on Twitter! I will make sure to update this post if we up solving it. In the meantime, the solution above is working great for us.

Happy coding debugging!!

Comments

[shazz]

Hello,

I am getting "Webpacker can't find application ..." error with rest of the same messages that you were getting. Any suggestion on what to do?

Thank you for your post.

Shazz.

[wariszargar]

Don't worry @shazz just do these thing to solve the actual no need to used above solution

I am facing same issue I have ruby on rails 6 and I am using nvm to install node and npm Unfortunately I have install latest version of node but not install LTS verion. When i am going to create new app then it give warning you are using unstable version of node js. I ignore this error but when I got this error I search about that. But fortunateloy I have foound that I am using latest version .

First Step

Install stable version nvm install 14.15.4 and you can check nodejs.org/en/ latest version from here

Second Step

nvm uninstall 15.6.0 which is latest version this commond actually remove node version

Last step nvm alias default 14.15.4

After this create new app & enjoy