Conflicting component dependencies

Last update: November 6, 2024

CREATED FOR:

  • Developer

This article provides a solution for conflicting component dependencies. When trying to setup or update Adobe Commerce using the Web Setup Wizard, you see the “We found conflicting component dependencies” Composer error message.

Affected products and versions

  • Adobe Commerce on-premises 2.2.x, 2.3.x
  • Adobe Commerce on cloud infrastructure 2.2.x, 2.3.x
  • Magento Open Source 2.2.x, 2.3.x

Issue

A conflicting component dependencies error message similar to the following (actual package names and versions will vary):

We found conflicting component dependencies.
You are trying to update package(s) magento/module-sample-data to 1.0.0-beta
We have detected conflicts with the following packages:
- magento/sample-data version 0.74.0-beta15. Please try to update it to one of the following package versions: 0.74.0-beta16, 0.74.0-beta14, 0.74.0-beta13, 0.74.0-beta12, 0.74.0-beta11, 0.74.0-beta10, 0.74.0-beta9, 0.74.0-beta8, 0.74.0-beta7

Cause

This message is displayed if Composer cannot determine which components to install or update.

Solution

Two main scenarios can lead to conflicting component dependencies. Click on your scenario to get troubleshooting steps.

Upgrading Adobe Commerce

If you are upgrading Adobe Commerce on cloud infrastructure, try the following to resolve conflicting component dependencies:

Incompatibility with third-party modules:

Conflicting component dependencies can also be caused by third-party modules that depend on earlier Commerce components than the ones you have installed. Try the following:

  1. In the preceding example, the installed package magento/sample-data version 0.74.0-beta15 cannot be upgraded to 1.0.0-beta. However, 0.74.0-beta15 can be upgraded to 0.74.0-beta16 (or others). Edit composer.json to make any of these changes. Typically, the versions your project is requesting will be defined in the require or require-dev property of the object in that JSON file. Depending on the options of package versions provided, they might specify a specific version or a constraint. For general guidance on how to use composer, if you are on our cloud infrastructure, you can refer to Cloud for Adobe Commerce > Technologies and Requirements > Composer in our developer documentation. If you are on Adobe Commerce on-premises, refer to Adobe Commerce > Installation Guide > Install Adobe Commerce Using the Composer .
  2. Now try the readiness check. Review Adobe Commerce Upgrade Overview > Run the Module Manager > Step 1 Readiness Check in our developer documentation.
  3. If the readiness check fails with another Component dependency check failure message, click on the following links depending on whether you are using Adobe Commerce or Magento Open Source to get further troubleshooting steps.