---
url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
title: '업데이트 후 문제 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T14:17:40+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  잘못된 업데이트를 마무리합니다. 거의 모든 경우 코드는 업데이트되었지만 데이터베이스는 업데이트되지 않았거나, 남아 있는 모듈 사본이 방해하거나, 종속성이 누락된 것입니다.
  올바른 순서로 업데이트 실행

  데이터베이스를 백업합니다.
   composer require drupal/dxpr_builder를 실행합니다. 릴리스를 고정한다면 버전 제약을 지정합니다.
   drush updb -y를 실행합니다(/update.php 방문도 가능).
   drush cr을 실행합니다.
  빌더 페이지 하나를 열고 다시 저장합니다.

  Important: 업데이트를 위해 모듈을 절대 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다.
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: '업데이트 후 문제'
      description: |-
        잘못된 업데이트를 마무리합니다. 거의 모든 경우 코드는 업데이트되었지만 데이터베이스는 업데이트되지 않았거나, 남아 있는 모듈 사본이 방해하거나, 종속성이 누락된 것입니다.
        올바른 순서로 업데이트 실행

        데이터베이스를 백업합니다.
         composer require drupal/dxpr_builder를 실행합니다. 릴리스를 고정한다면 버전 제약을 지정합니다.
         drush updb -y를 실행합니다(/update.php 방문도 가능).
         drush cr을 실행합니다.
        빌더 페이지 하나를 열고 다시 저장합니다.

        Important: 업데이트를 위해 모듈을 절대 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T14:17:40+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/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
      articleSection: '문제 해결'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating'
      description: |-
        잘못된 업데이트를 마무리합니다. 거의 모든 경우 코드는 업데이트되었지만 데이터베이스는 업데이트되지 않았거나, 남아 있는 모듈 사본이 방해하거나, 종속성이 누락된 것입니다.
        올바른 순서로 업데이트 실행

        데이터베이스를 백업합니다.
         composer require drupal/dxpr_builder를 실행합니다. 릴리스를 고정한다면 버전 제약을 지정합니다.
         drush updb -y를 실행합니다(/update.php 방문도 가능).
         drush cr을 실행합니다.
        빌더 페이지 하나를 열고 다시 저장합니다.

        Important: 업데이트를 위해 모듈을 절대 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 홈
            item: 'https://dxpr.com/ko'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: ko
---
[도움말 센터](/ko/node/75)/[문서](/ko/hc/documentation) /[DXPR Builder 배우기](/ko/hc/documentation/learn-dxpr-builder) /[사이트 관리](/ko/hc/documentation/learn-dxpr-builder/manage) /[문제 해결](/ko/hc/documentation/learn-dxpr-builder/troubleshooting) # 업데이트 후 문제.

 DXPR Builder 배우기사이트 관리문제 해결

   ## 이 가이드의 내용

 관련 가이드

- [DXPR Builder 업데이트](/ko/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. 빌더 페이지 하나를 열고 다시 저장합니다.

**Important:** 업데이트를 위해 모듈을 절대 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다.

## 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” 또는 “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`를 실행합니다.

## 업데이트 후 페이지가 깨져 보입니다

일부 릴리스는 `drush updb` 실행 중에 배치 방식으로 이전 마크업을 새 형식으로 변환합니다(예: Owl 캐러셀, 원형 카운터). 실패한 항목은 대기 상태로 남습니다.

1. 다음으로 이동합니다: **DXPR Studio** > **DXPR Builder** > **Content items** > **Migrations**(`/admin/dxpr_studio/dxpr_builder/migration-status`).
2. 마이그레이션에 **Pending**이 표시되면 **Run now** 또는 **Run all pending migrations**을 클릭합니다.
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`가 다음 메이저를 실수로 가져올 수 있습니다.

## 업데이트 직후 에디터가 고장났습니다

다음 문서를 따릅니다: [The editor does not appear](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading). 부분 업데이트 후에 나타나는 주요 원인이 그곳에 있습니다. 보류 중인 데이터베이스 업데이트, 오래된 파일, 이전 릴리스로 빌드된 집계 캐시입니다.

## Glazed Builder에서 마이그레이션합니다

DXPR Builder 3.x는 저장된 콘텐츠의 Glazed 클래스 이름을 더 이상 변환하지 않습니다. 먼저 마지막 2.x 릴리스로 업데이트하고 데이터베이스 업데이트를 실행한 뒤 3.x로 업데이트합니다. [Migrating from DXPR Builder 1.x or 2.x](/ko/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x)를 참조합니다.

## 수정 확인하기

`drush updb`에 보류 중인 업데이트가 없고, `drush pm:list --filter=dxpr`에 의도한 버전이 표시되며, 다시 저장한 빌더 페이지가 에디터와 방문자에게 동일하게 렌더링됩니다.

## 다음 단계

[Updating DXPR Builder](/ko/hc/documentation/learn-dxpr-builder/getting-started/updating)에서 정기 업데이트 절차를 확인합니다.