---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
title: '更新后问题 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T08:22:36+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  完成出错的更新。几乎所有情况下，代码已更新但数据库未更新，或有多余的模块副本挡路，或缺少依赖。
  按正确顺序运行更新

  备份数据库。
  运行 composer require drupal/dxpr_builder，如果锁定版本可带版本约束。
  运行 drush updb -y （或访问 /update.php).
  运行 drush cr.
  打开一个页面构建器页面并再次保存。

  重要： 切勿卸载模块来更新。卸载会删除已保存的模板、资料和设置。
tags:
  - 'Een probleem oplossen'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T09:09:48+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 更新后问题
      description: |-
        完成出错的更新。几乎所有情况下，代码已更新但数据库未更新，或有多余的模块副本挡路，或缺少依赖。
        按正确顺序运行更新

        备份数据库。
        运行 composer require drupal/dxpr_builder，如果锁定版本可带版本约束。
        运行 drush updb -y （或访问 /update.php).
        运行 drush cr.
        打开一个页面构建器页面并再次保存。

        重要： 切勿卸载模块来更新。卸载会删除已保存的模板、资料和设置。
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T08:22:36+0000'
      dateModified: '2026-10-24T09:09:48+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/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
      articleSection: 'Een probleem oplossen'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
      description: |-
        完成出错的更新。几乎所有情况下，代码已更新但数据库未更新，或有多余的模块副本挡路，或缺少依赖。
        按正确顺序运行更新

        备份数据库。
        运行 composer require drupal/dxpr_builder，如果锁定版本可带版本约束。
        运行 drush updb -y （或访问 /update.php).
        运行 drush cr.
        打开一个页面构建器页面并再次保存。

        重要： 切勿卸载模块来更新。卸载会删除已保存的模板、资料和设置。
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 首页
            item: 'https://dxpr.com/zh-hans'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: zh-hans
---
[Help Center](/zh-hans/node/75)/[Documentation](/zh-hans/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Een probleem oplossen](/hc/documentation/learn-dxpr-builder/troubleshooting) # 更新后问题.

 Learn DXPR BuilderManage the siteEen probleem oplossen

   ## In this guide

 Related guides

- [Updating](/hc/documentation/learn-dxpr-builder/getting-started/updating)

完成出错的更新。几乎所有情况下，代码已更新但数据库未更新，或有多余的模块副本挡路，或缺少依赖。

## 按正确顺序运行更新

1. 备份数据库。
2. 运行 `composer require drupal/dxpr_builder`，如果锁定版本可带版本约束。
3. 运行 `drush updb -y` （或访问 `/update.php`).
4. 运行 `drush cr`.
5. 打开一个页面构建器页面并再次保存。

**重要：** 切勿卸载模块来更新。卸载会删除已保存的模板、资料和设置。

## Composer 报错

- **"Could not find a version of package drupal/dxpr\_builder matching your minimum-stability".** 3.x 以测试版形式发布。在约束中允许它们： `composer require 'drupal/dxpr_builder:^3.0@beta'`.
- **"Could not find a matching version of package dxpr/dxpr\_builder".** drupal.org 上的包为 `drupal/dxpr_builder`。替换 `dxpr/dxpr_builder` 与 `drupal/dxpr_builder` ： `composer.json`，然后运行 `composer update drupal/dxpr_builder`.
- **Composer 拒绝，因为该文件夹不受 Composer 管理。** 手动上传了一个副本。删除 `modules/contrib/dxpr_builder` 并再次运行 require 命令。
- **"Disk quota exceeded" or "write failed".** 重试前释放服务器磁盘空间。

## 数据库更新失败

- **"Unable to install modules key due to missing modules key".**3.x 需要 Key 模块，更新 9020 会安装它。其代码缺失是因为模块未通过 Composer 安装。运行 `composer require drupal/key`，然后 `drush updb -y` 再次。
- **命名更新钩子失败。** 运行 `drush updb -vvv` 并在工单中附上完整报错。
- **"module 'dxpr\_builder\_page' is missing its dependency module field\_group".** DXPR Builder Drag and Drop Page 子模块需要 Field Group。运行 `composer require drupal/field_group`，然后 `drush en dxpr_builder_page -y`.

## 更新后页面显示损坏

一些版本在以下期间批量转换旧标记，如 Owl 轮播和圆计数器 `drush updb`。失败的条目保持待定。

1. 前往 **DXPR Studio** > **DXPR Builder** > **Content items** > **Migrations**(`/admin/dxpr_studio/dxpr_builder/migration-status`).
2. 如果迁移显示 **待定**，点击 **Run now**，或 **运行所有待定迁移**。
3. 检查 **Reports** > **Recent log messages** 批量跳过的条目。

## Composer 拒绝 Drupal 核心大版本升级

DXPR Builder 3.x 支持 Drupal 10.2 及更高版本，以及 Drupal 11。

1. 查看 DXPR Builder、DXPR Theme 和 DXPR Theme Helper 的发行说明，找到支持新大版本的版本。
2. 运行 Upgrade Status 查看哪些包尚未就绪。
3. 在以下位置锁定核心大版本 `composer.json`。无约束的 `composer require drupal/core-recommended` 可能意外拉取下一个大版本。

## 更新后编辑器损坏

遵循 [编辑器不出现](/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading)。部分更新后遗留问题是最常见的原因：待处理的数据库更新、过时的文件，以及基于旧版本构建的聚合缓存。

## 我正在从 Glazed Builder 迁移

DXPR Builder 3.x 不再转换存储内容中的 Glazed 类名。请先更新到最新的 2.x 版本并运行其数据库更新，然后更新到 3.x。参见 [从 DXPR Builder 1.x 或 2.x 迁移](/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x)。

## 确认修复

`drush updb` 报告无待定更新， `drush pm:list --filter=dxpr` 显示预期版本，重新保存的页面构建器页面在编辑器和访客端渲染一致。

## 接下来做什么？

[更新 DXPR Builder](/hc/documentation/learn-dxpr-builder/getting-started/updating) 了解常规更新流程。