CODEWITHSUNDEEP
csswebpackmini-css-extract-plugin
sevaTechnoPark
sevaTechnoPark

Reputation: 421

mini-css-extract-plugin WARNING in chunk chunkName [mini-css-extract-plugin] Conflicting order between:

WARNING in chunk AccessRights~Groups~Navigator [mini-css-extract-plugin] Conflicting order between:

what does this mean and how to fix it? Thank you in advance!

"assets-webpack-plugin": "3.9.5",
"autoprefixer": "9.1.0",
"css-loader": "1.0.0",
"file-loader": "1.1.11",
"image-webpack-loader": "4.3.1",
"mini-css-extract-plugin": "0.4.2",
"postcss-advanced-variables": "2.3.3",
"postcss-clearfix": "2.0.1",
"postcss-conditionals": "2.1.0",
"postcss-extend": "1.0.5",
"postcss-functions": "3.0.0",
"postcss-hexrgba": "1.0.1",
"postcss-import": "12.0.0",
"postcss-loader": "2.1.6",
"postcss-media-minmax": "3.0.0",
"postcss-nested": "3.0.0",
"postcss-sassy-mixins": "2.1.0",
"postcss-simple-vars": "4.1.0",
"postcss-size": "2.0.0",
"postcss-urlrewrite": "0.2.2",
"source-map-loader": "0.2.3",
"string-replace-loader": "2.1.1",
"style-loader": "0.22.0",
"url-loader": "1.0.1",
"webpack": "4.16.5",
"webpack-cli": "3.1.0",
"webpack-dev-server": "3.1.5",

Upvotes: 41

Views: 30610

Answers (7)

Muhammad Saad Ali Khan
Muhammad Saad Ali Khan

Reputation: 184

This issue appears when Webpack attempts to fulfill a desired order for processing CSS chunks, but these specific files disrupt that order due to their dependencies. For me this solution worked perfectly.

  1. Remove node_modules folder
  2. Run npm cache clean --force command.
  3. Add these lines to my config.overrides.js file.
const webpack = require("webpack");
const MiniCssExtractPlugin = require("mini-css-extract-plugin");

const miniCssExtractPlugin = config.plugins.find(
    (plugin) => plugin.constructor.name === "MiniCssExtractPlugin"
  );

  if (miniCssExtractPlugin) {
    miniCssExtractPlugin.options.ignoreOrder = true;
  }
  1. Then run npm i to install dependencies.
  2. Then run npm rebuild node-sass.

Hope this will resolve the issue.

Upvotes: 0

whoacowboy
whoacowboy

Reputation: 7447

In case anyone is using Quasar and is coming to this issue 2 years late, like me, here is how I updated my quasar.config.js file to kill the warnings as @Aidin suggests.

// quasar.config.js

module.exports = configure(function (ctx) {
  //...
  return {
    //...
    chainWebpack(chain) {
      //...
      if (ctx.prod) {
        chain.plugin('mini-css-extract')
          .tap(args => {
            args[0].ignoreOrder = true
            return args
          })
      }
    }
  }
}

Razvan's Github comment was very useful.

Upvotes: 0

Aidin
Aidin

Reputation: 29987

It can easily become an annoying bug! I can see it being reported in every framework -- e.g. in issue #5372 in create-react-app, issue #250 in the mini-css-extract-plugin itself, etc.

I spent 6 hours debugging it (including putting console.log in the source code of mini-css-extract-plugin where it omits the Warning) and here are my findings.

What is this plugin?

The mini-css-extract-plugin of webpack is a CSS-bundler. It is there to gather CSS pieces and put them into .css chunks for you. Just like what the whole Webpack build is doing for .js files.

Why is it happening to me?

You are running into it because all of these conditions apply to you:

  1. You have Vue SFC or CSS-in-JS, that results in your CSS content being in different files (which are called modules).
  2. Your webpack configurations are set to do some sort of code-splitting optimizations, (e.g. via split-chunks-plugin) which puts your modules into chunks for lazy-loading in client-side (e.g. 1000 files, into 10 chunks, that are only downloaded by the user when the user needs them.) So, this plugin goes over how webpack has bundled your modules and tries to create its own CSS bundles out of them.
  3. There is an "Order Conflict" in your imports!

What is "Order Conflict" now?

It's "order" + "conflict." Let's review them.

Part 1) Order

This plugin is trying to run a topological sorting algorithm (this part of the source code) to find out in which order it should put the CSS rules in its output bundles so that it doesn't cause any problem.

The problem is, unlike JavaScript that you clearly export your objects from a file/module (in no order, as they are named), in CSS it will just get appended (like an array of strings) and so the order of the imports can actually matter!

Let's say you have two modules:

// module a.js
<div>hi, I am A!</div>
// ... in CSS section of the same file:
div { color: red; }

// module b.js
<div>hi, I am B!</div>
// ... in CSS section of the same file:
div { color: blue; }

And then you have a page that includes both of them them.

// page S (for Straight)
import a from "a.js"
import b from "b.js"

So far, so good! The CSS output can be

div { color: red; }
div { color: blue; }

which means all the <div>s should have blue font color.

However, if instead of that page S, we had a page had was importing them in reverse order, it would be:

// page R (for Reverse)
import b from "b.js"
import a from "a.js"

and the output would be equal to

div { color: blue; }
div { color: red; }

which means all the <div>s should have red font color.

This is why the order of imports matters.

Part 2) Conflict

Now, what should be the output CSS if you have both page S and page R?

Note that, unlike this silly example of applying a wild rule on all <div> elements, you might actually have some sort of scoped CSS or a CSS naming convention like BEM in place that would prevent such thing to become an issue. But, this plugin doesn't go over actually parsing and understanding the content of the CSS. It just complains that "Hey dude! I don't know whether a should come before b, or b should come before a!"

Solutions

You basically have two solutions, just like any other problem! Either solve it or kill the problem it.

Solution 1: Fix it

The error message is very hard to read and sometimes it doesn't even output the proper details of modules. (for me it's like , , , , , , as for some reason my ChunkGroups don't have a .name property; so zero information.) And it can be extremely messy if you have more than ~20 files.

Anyways, if you have got time this approach is the best you can try.

Notes:

  • You can also import PageS in PageR (or the other way around, whatever) to explicitly tell the plugin to pick this order and stop nagging! It might be easier than going over all the places that include one or another and move the lines up and down.
  • IMPORTANT NOTE 1: IF YOU THINK SORTING YOUR IMPORT LINES ALPHABETICALLY CAN HELP, SEE THIS EXAMPLE and THIS COMMENT (that even a Visual Code plugin cannot help)!
  • IMPORTANT NOTE 2: The Order Conflict is NOT NECESSARILY IN THE SAME FILE. It can be anywhere among the ancestors of the two or more files! So, can be a huge pain to find out.
  • IMPORTANT NOTE 3: IT'S NOT GOING TO BE FUTURE-PROOF! So, even if you move a few import lines up and down, tomorrow it might happen to another developer in your team.

So, TL;DR, if you found yourself spending more than two hours on this, try solution #2 below.

Solution 2: Kill it

If it's not actually causing a problem in production and your final output, you can suppress this error via passing an ignoreOrder flag to the options object of the plugin in your Webpack config.

Notes:

It's a good last resort! Good luck. :)

Upvotes: 66

UtkarshPramodGupta
UtkarshPramodGupta

Reputation: 8152

CSS cares for rule order.

Q: What does the warning mean?

A: There are some order conflicts while packaging your CSS modules.

Q: What is the cause?

A: The plugin (mini-css-extract-plugin) tries to generate a CSS file but your codebase has multiple possible orderings for your modules. From the warning you showed, it seems you have used Icon before Counter in one location and Counter before Icon in another location. The plugin needs to generate a single CSS file from these and can't decide which module's CSS should be placed first. CSS cares for rule order so this can lead to issue when CSS changes without reason. So not defining a clear order can lead to fragile builds, that's why it displays a warning here.

Q: How to fix?

A: Sort your imports to create a consistent order. If you cannot sort for some reason, for example, you have libraries in your project beyond your control or when the order of these styles doesn't matter, you can ignore the warning by making changes as suggested in other answers.

Upvotes: 26

Stephen Isienyi
Stephen Isienyi

Reputation: 1352

There is now an NPM package named @webkrafters/ordercss which tackles this issue at the root.

Full disclosure: I initially created it to solve this very problem in one of my apps but decided to expand it and share it with everyone.

If this package helps anyone, please share it with others.

Thanks and good luck!

NB: setting MiniCssExtractPlugin ignoreOrder property would suppress the warnings but may not resolve the underlying issues especially for those using modular css. This could result in unpredictability of the rendered view.

Upvotes: 2

Sithu
Sithu

Reputation: 4862

mini-css-extract-plugin version 0.8.0 included a new option ignoreOrder. You can check https://github.com/webpack-contrib/mini-css-extract-plugin#remove-order-warnings

new MiniCssExtractPlugin({
  ignoreOrder: true,
}),

Upvotes: 12

江 河
江 河

Reputation: 81

Please see issue reported on Github.

 const webpackConfig = {
   stats: {
                  // warn => /Conflicting order between:/gm.test(warn)
     warningsFilter: warn => warn.indexOf('Conflicting order between:') > -1 // if true will ignore
   }
 }

Upvotes: 4

Related Questions