How do I fix a "Mismatched entity and/or field definitions" error on my configuration?

Question

I'm getting the following error on my Drupal 8 configuration page.

Entity/field definitions
Mismatched entity and/or field definitions
The following changes were detected in the entity type and field definitions.

Content Update the node.rng_capacity field. Update the node.rng_registrants_duplicate field. Update the node.rng_registration_groups field. Update the node.rng_registration_type field. Update the node.rng_reply_to field. Update the node.rng_status field.

I'm not sure what caused these issues or how to go about resolving them. I think they may be leftover fragments/elements from when I deleted a registration or entity type.

Answer 1

You can solve this issue by two ways.

If you installed Drush, you can run drush entity-updates. Otherwise, add the following lines in the index.php file located in the Drupal root folder, before $response->send(); and reload the page.

try {
  \Drupal::entityDefinitionUpdateManager()->applyUpdates();
}
catch (EntityStorageException $e) {
  print_r($e);
}

Then remove the code from the index.php file.

Answer 2

Solved!

Method 1: Go to the admin/reports/status and find the field machine name.

For Example: "paragraph.field_video_upload". Edit the field storage settings and save the configuration again. That's it.

It works.

(or)

Method 2: If it's not working, please try the method below.

.install

<?php

/**
 * Implements hook_update_N().
 */
function HOOK_update_9001() {

  $entity_type_manager = \Drupal::entityTypeManager();
  $entity_type_manager->clearCachedDefinitions();

  $entity_type_ids = [];
  $change_summary = \Drupal::service('entity.definition_update_manager')->getChangeSummary();
  foreach ($change_summary as $entity_type_id => $change_list) {
    $entity_type = $entity_type_manager->getDefinition($entity_type_id);
    \Drupal::entityDefinitionUpdateManager()->installEntityType($entity_type);
    $entity_type_ids[] = $entity_type_id;
  }

  return t("Installed/Updated the entity type(s): @entity_type_ids", [
    '@entity_type_ids' => implode(', ', $entity_type_ids),
  ]);
}

RUN drush cim & drush cr

Answer 3

drush entity-updates (aka drush entup) has been deprecated as of Drupal 8.7.0. You either need to write an update script using hook_update_N(), or you can use the Devel Entity Updates module, which does the same thing as drush entup did previous to 8.7.0.

Answer 4

Find the field in /admin/reports/fields. For each entity that uses the field, edit the field and save the parameters again.

This should be updating the database and make the entity and the field match again.

Answer 5

For Drupal 9, use devel_entity_updates module

composer require 'drupal/devel_entity_updates'
drush en devel_entity_updates
drush entity-updates

should fix the issue.

Answer 6

It is clearly written in the Devel Entity Updates:

Do not use this to fix the Mismatched entity and/or field definitions error: again, this is not meant to fix production sites.

This will not help these issues.

Here some links that could fix the issues:

https://www.drupal.org/project/paragraphs/issues/3062300 https://www.drupal.org/project/commerce/issues/2656896

Answer 7

For Drupal 8 and Drupal 9, there is the Entity Update module, which allows to update an entity schema with Drush or without it.

The main objective of this module is to allow module developers and site administrators to update entity types schema even when entities have data.
The update can be executed via Drush (recommended), from the web browser, or programmatically.
The module also allows to view the list of entity types, the entity types update status, and show the content of an entity type.

Answer 8

For Drupal 10 or Migrated from Drupal 9 to Drupal 10, or migrated Contrib modules like Paragraph

You need to add devel_entity_updates

$ drush composer require 'drupal/devel_entity_updates:^4.1'

Then Enable

And Run the Drush command

$ drush devel_entity_updates

The following updates are pending:

paragraph entity type : 
The paragraph.field_reusable_paragraph field needs to be updated.

 Do you wish to run all pending updates? (yes/no) [yes]:
 > yes

 [success] Finished performing updates.

This resolved the above issue

Answer 9

You can Add hook_update_N() hook (in module_name.install file): to fix Mismatched entity and/or field definitions error for Configuration

/**
 * Update the Paragraph field definitions for mismatched fields.
 */
function hook_update_N() {
  try {

    $entityTypeManager = \Drupal::entityTypeManager();

    // Get the media entity type.
    $paragraphEntityType = $entityTypeManager->getDefinition('paragraph');

    // Install the media entity type to ensure field updates.
    \Drupal::entityDefinitionUpdateManager()->installEntityType($paragraphEntityType);

  }
  catch (\Exception $e) {
    watchdog_exception('logger_name', $e, 'hook_update_N failed');
  }
}

Note: I used nkf_update_8901() for hook_update_N(), where module_name : nkf, N denotes 8901

Follow this document to read more about hook_update_N() hook

I have used this approach to fix a "Mismatched entity and/or field definitions" error for Configuration due to couple of reasons:

In some projects :

• Lower(dev) env can use "devel entity updates" but on higher(stg/prod) it is not recommended to use "devel entity updates" module. so in this particular scenario this approach hook_update_N() can be used

• It also helps to keep track of recent changes related to particular entity updates of db at code level

Answer 10

You can use the below code(on module_name.install file) to fix this mismatched entity issue. I tried this on Drupal 10 version. Please post your comment if you need any clarification on this.

/**
 *
 * Mismatched entity and/or field definitions Fix.
 */
function hook_update_N() {

  $entity_type_manager = \Drupal::entityTypeManager();
  $entity_type_manager->clearCachedDefinitions();
  $entity_type_ids = [];
  $change_summary = \Drupal::service('entity.definition_update_manager')->getChangeSummary();
  foreach ($change_summary as $entity_type_id => $change_list) {
    $entity_type = $entity_type_manager->getDefinition($entity_type_id);
    \Drupal::entityDefinitionUpdateManager()->installEntityType($entity_type);
    $entity_type_ids[] = $entity_type_id;
  }
  drupal_flush_all_caches();
  return t("Installed/Updated the entity type(s): @entity_type_ids", [
    '@entity_type_ids' => implode(', ', $entity_type_ids),
  ]);
}