---
url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-atualizar'
title: 'Problemas depois de atualizar | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T09:04:28+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  Termine uma atualização que correu mal. Em quase todos os casos, o código foi
  atualizado mas a base de dados não, uma cópia restante do módulo está
  no caminho ou falta uma dependência.
tags:
  - 'Fix a problem'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T17:19:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Problemas depois de atualizar'
      description: |-
        Termine uma atualização que correu mal. Em quase todos os casos, o código foi
        atualizado mas a base de dados não, uma cópia restante do módulo está
        no caminho ou falta uma dependência.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T09:04:28+0000'
      dateModified: '2026-10-24T17:19:22+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-atualizar'
      articleSection: 'Resolver um problema'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-atualizar'
      description: |-
        Termine uma atualização que correu mal. Em quase todos os casos, o código foi
        atualizado mas a base de dados não, uma cópia restante do módulo está
        no caminho ou falta uma dependência.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Início
            item: 'https://dxpr.com/pt-pt'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: pt-pt
---
[Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentacao) /[Aprender DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder) /[Gerir o site](/pt-pt/hc/documentation/learn-dxpr-builder/manage) /[Resolver um problema](/pt-pt/hc/documentation/learn-dxpr-builder/troubleshooting) # Problemas depois de atualizar.

 Aprender DXPR BuilderGerir o siteResolver um problema

   ## Neste guia

 Guias relacionados

- [Atualizar o DXPR Builder](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar)

Termine uma atualização que correu mal. Em quase todos os casos, o código foi atualizado mas a base de dados não, uma cópia restante do módulo está no caminho ou falta uma dependência.

## Corra a atualização pela ordem certa

1. Faça uma cópia de segurança da base de dados.
2. Corra `composer require drupal/dxpr_builder`, com uma restrição de versão se fixar lançamentos.
3. Corra `drush updb -y` (ou visite `/update.php`).
4. Corra `drush cr`.
5. Abra uma página do construtor e guarde-a de novo.

**Importante:** nunca desinstale o módulo para o atualizar. Desinstalar apaga modelos guardados, perfis e definições.

## O Composer mostra um erro

- **"Could not find a version of package drupal/dxpr\_builder matching your minimum-stability".** O 3.x é publicado como lançamentos beta. Permita-os na restrição: `composer require 'drupal/dxpr_builder:^3.0@beta'`.
- **"Could not find a matching version of package dxpr/dxpr\_builder".** O pacote em drupal.org é `drupal/dxpr_builder`. Substitua `dxpr/dxpr_builder` por `drupal/dxpr_builder` em `composer.json` e depois corra `composer update drupal/dxpr_builder`.
- **O Composer recusa porque a pasta não é gerida pelo Composer.** Uma cópia foi carregada à mão. Apague `modules/contrib/dxpr_builder` e corra de novo o comando require.
- **"Disk quota exceeded" ou "write failed".** Liberte espaço em disco no servidor antes de tentar de novo.

## A atualização da base de dados falha

- **"Unable to install modules key due to missing modules key".**O 3.x precisa do módulo Key e a atualização 9020 instala-o. O seu código falta porque o módulo não foi instalado com o Composer. Corra `composer require drupal/key` e depois `drush updb -y` de novo.
- **Um update hook nomeado falha.** Corra `drush updb -vvv` e inclua o erro completo no seu ticket.
- **"module 'dxpr\_builder\_page' is missing its dependency module field\_group".** O submódulo DXPR Builder Drag and Drop Page precisa de Field Group. Corra `composer require drupal/field_group`e depois `drush en dxpr_builder_page -y`.

## As páginas ficam partidas depois da atualização

Alguns lançamentos convertem marcação antiga, como carrosséis Owl e contadores circulares, em lotes durante `drush updb`. Os itens que falham ficam pendentes.

1. Vá a **DXPR Studio** > **DXPR Builder** > **Content items** > **Migrations**(`/admin/dxpr_studio/dxpr_builder/migration-status`).
2. Se uma migração mostra **Pending**, clique em **Run now** ou em **Run all pending migrations**.
3. Verifique **Reports** > **Recent log messages** para os itens que um lote saltou.

## O Composer recusa uma atualização principal do núcleo Drupal

O DXPR Builder 3.x suporta Drupal 10.2 e posterior, e Drupal 11.

1. Verifique as notas de lançamento do DXPR Builder, DXPR Theme e DXPR Theme Helper para a versão que suporta a nova principal.
2. Corra Upgrade Status para ver que pacotes não estão prontos.
3. Fixe a principal do núcleo em `composer.json`. Um `composer require drupal/core-recommended` sem restrição pode puxar a próxima principal por acidente.

## O editor partiu-se logo depois da atualização

Siga [O editor não aparece](/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/editor-nao-aparece). As principais causas lá são as que seguem uma atualização parcial: atualizações pendentes da base de dados, ficheiros desatualizados e uma cache de agregação construída a partir do lançamento antigo.

## Estou a migrar do Glazed Builder

O DXPR Builder 3.x já não converte nomes de classes Glazed no conteúdo guardado. Atualize primeiro para o último lançamento 2.x e corra as suas atualizações da base de dados, depois atualize para 3.x. Veja [Migrar do DXPR Builder 1.x ou 2.x](/pt-pt/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x).

## Confirmar a correção

`drush updb` não indica atualizações pendentes, `drush pm:list --filter=dxpr` mostra as versões pretendidas e uma página do construtor guardada de novo apresenta-se igual no editor e para um visitante.

## E a seguir?

[Atualizar o DXPR Builder](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar) para o procedimento de atualização de rotina.