--- url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading' title: '에디터가 나타나지 않습니다 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T14:17:17+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- 페이지를 여는데 콘텐츠를 가리켜도 아무 일도 일어나지 않거나, 컨트롤은 표시되는데 설정 대화상자가 열리지 않습니다. 아래 원인을 순서대로 확인합니다. 처음 네 가지가 대부분의 경우에 해당합니다. 노드 편집 양식에 있습니다 에디터는 편집 양식이 아니라 페이지 자체에서 실행됩니다. 노드를 저장하고 페이지를 연 뒤 콘텐츠 영역을 가리킵니다. 에디터는 /node/12/revisions/34/view 같은 리비전 페이지에서도 꺼져 있습니다. 페이지에 제품 키 또는 라이선스 메시지가 표시됩니다 다음 메시지 중 하나가 표시되는 동안 에디터는 꺼져 있습니다. 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: |- 페이지를 여는데 콘텐츠를 가리켜도 아무 일도 일어나지 않거나, 컨트롤은 표시되는데 설정 대화상자가 열리지 않습니다. 아래 원인을 순서대로 확인합니다. 처음 네 가지가 대부분의 경우에 해당합니다. 노드 편집 양식에 있습니다 에디터는 편집 양식이 아니라 페이지 자체에서 실행됩니다. 노드를 저장하고 페이지를 연 뒤 콘텐츠 영역을 가리킵니다. 에디터는 /node/12/revisions/34/view 같은 리비전 페이지에서도 꺼져 있습니다. 페이지에 제품 키 또는 라이선스 메시지가 표시됩니다 다음 메시지 중 하나가 표시되는 동안 에디터는 꺼져 있습니다. 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:17+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/editor-not-loading' articleSection: '문제 해결' - '@type': WebPage '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading' description: |- 페이지를 여는데 콘텐츠를 가리켜도 아무 일도 일어나지 않거나, 컨트롤은 표시되는데 설정 대화상자가 열리지 않습니다. 아래 원인을 순서대로 확인합니다. 처음 네 가지가 대부분의 경우에 해당합니다. 노드 편집 양식에 있습니다 에디터는 편집 양식이 아니라 페이지 자체에서 실행됩니다. 노드를 저장하고 페이지를 연 뒤 콘텐츠 영역을 가리킵니다. 에디터는 /node/12/revisions/34/view 같은 리비전 페이지에서도 꺼져 있습니다. 페이지에 제품 키 또는 라이선스 메시지가 표시됩니다 다음 메시지 중 하나가 표시되는 동안 에디터는 꺼져 있습니다. 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 배우기사이트 관리문제 해결 ## 이 가이드의 내용 관련 가이드 - [업데이트 후 문제](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating) 페이지를 여는데 콘텐츠를 가리켜도 아무 일도 일어나지 않거나, 컨트롤은 표시되는데 설정 대화상자가 열리지 않습니다. 아래 원인을 순서대로 확인합니다. 처음 네 가지가 대부분의 경우에 해당합니다. ## 노드 편집 양식에 있습니다 에디터는 편집 양식이 아니라 페이지 자체에서 실행됩니다. 노드를 저장하고 페이지를 연 뒤 콘텐츠 영역을 가리킵니다. 에디터는 `/node/12/revisions/34/view` 같은 리비전 페이지에서도 꺼져 있습니다. ## 페이지에 제품 키 또는 라이선스 메시지가 표시됩니다 다음 메시지 중 하나가 표시되는 동안 에디터는 꺼져 있습니다. - **"DXPR Builder needs a product key to work".** 제품 키가 설정되지 않았습니다. 다음 경로로 이동합니다. **DXPR Studio** > **DXPR Builder** > **General Settings**(`/admin/dxpr_studio/dxpr_builder/settings`)에서 **License** 섹션을 작성합니다. - **"Oops, the no-code editor is not loading here".** 메시지에 원인이 나와 있습니다. 사용자 라이선스 부족, 요금제의 콘텐츠 항목 한도, 유효한 이메일 주소가 없는 계정 중 하나입니다. [Licence and product key errors](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/licence-and-product-key)를 따릅니다. - **"Access to DXPR Builder is blocked because of a payment or licensing problem".** DXPR이 사이트 도메인을 차단했습니다. 메시지의 링크를 통해 DXPR에 문의합니다. ## 콘솔에 cdn2.dxpr.com의 401 또는 403 오류가 표시됩니다 다음을 설정하면 에디터 스크립트가 URL의 제품 키와 함께 로드됩니다. **Asset source**를 **Cloud**로 설정하면 에디터 스크립트가 URL의 제품 키와 함께 `cdn2.dxpr.com`에서 로드됩니다. 401이나 403은 CDN이 키를 거부했다는 뜻입니다. **License** 섹션은 **General Settings**에서 확인한 뒤 [Licence and product key errors](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/licence-and-product-key)를 따릅니다. 대신 요청이 시간 초과되면 방화벽이 CDN을 차단합니다. [Using DXPR Builder behind a firewall](/ko/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)을 참조합니다. ## 업데이트 후 에디터가 중단됐습니다 1. 다음을 실행하거나 방문합니다. `drush updb -y`를 실행합니다(`/update.php` 방문도 가능). 2. 다음을 실행합니다. `drush cr`을 실행합니다. 3. 빌더 페이지 하나를 열고 다시 저장합니다. 모듈 폴더 안의 파일이 없다는 로그가 나오면 서버 코드가 불완전합니다. 코드를 다시 설치합니다. 1. 다음 폴더를 삭제합니다. `modules/contrib/dxpr_builder` 폴더를 삭제합니다. 2. 다음을 실행합니다. `composer require drupal/dxpr_builder`를 실행합니다. 3. 다음을 실행합니다. `drush cr`을 실행합니다. **Important:** 초기화하려고 모듈을 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다. ## 컨트롤은 표시되는데 설정 대화상자가 열리지 않습니다 콘솔에 `bootstrap is not defined` 또는 `getOrCreateInstance` 관련 오류가 표시됩니다. 에디터 대화상자는 Bootstrap 5 JavaScript에서 실행됩니다. 페이지에는 없거나 테마가 대신 Bootstrap 3이나 4를 로드합니다. 1. 다음으로 이동하고 섹션을 엽니다. **General Settings**로 이동하고 **Bootstrap** 섹션을 엽니다. 2. 테마가 Bootstrap 5를 로드하지 않으면 **Sideload Bootstrap files**를 **Bootstrap 5**로 설정하고 **Save settings**를 클릭합니다. 3. 테마가 Bootstrap 3이나 4 JavaScript를 로드하면 로드를 중단하거나 Bootstrap 5 테마로 바꿉니다. ## 콘솔에 다른 스크립트의 JavaScript 오류가 표시됩니다 페이지의 다른 스크립트가 에디터를 깨뜨리고 있습니다. 지원 티켓의 범인은 쿠키 동의 배너, 태그 관리자, MailChimp 삽입 코드, New Relic 브라우저 에이전트였습니다. Webpack 번들이나 자체 Bootstrap 3이나 4 JavaScript를 통한 테마도 원인이었고, JavaScript 축소기도 마찬가지였습니다. 1. 다음으로 이동하고 JavaScript 집계를 끕니다. **Configuration** > **Development** > **Performance**로 이동하고 JavaScript 집계를 끕니다. 다시 로드합니다. 2. 동의, 분석, 모니터링 모듈을 한 번에 하나씩 비활성화합니다. 각각 다시 로드합니다. 3. 한 번 테스트용으로 Olivero 같은 코어 테마로 바꿉니다. 결과가 알려주는 내용: - **Fixed by step 1:** 축소기가 원인입니다. Sortable 같은 에디터 헬퍼 라이브러리가 페이지 나머지 부분과 함께 집계되므로 집계 켜짐에서 `Sortable is not defined`가 여기를 가리킵니다. Advanced CSS/JS Aggregation에서는 축소기를 JSqueeze에서 JSMin으로 바꿉니다. - **Fixed by step 2:** 해당 모듈을 편집 페이지에서 비활성화한 채로 두거나, 충돌을 관리자에게 보고합니다. - **Fixed by step 3:** 테마 JavaScript가 원인입니다. 테마에서 Bootstrap 3이나 4 JavaScript 로드를 중단하고, **Sideload Bootstrap files**를 **Bootstrap 5**로 설정합니다. ## "The website encountered an unexpected error" 페이지가 표시됩니다 로그에는 다른 모듈의 View나 블록 클래스를 지정하는 `DxprBuilderService` 경유 스택 추적이 표시됩니다. 에디터용으로 빌더는 모든 View 디스플레이와 블록 플러그인을 나열하므로 페이지에 추가할 수 있습니다. 모든 방문자용으로 페이지에 배치된 블록과 Views를 렌더링합니다. 어느 단계에서든 오류를 던지는 고장 난 View나 블록 하나가 페이지를 중단시킵니다. 1. 다음을 열고 추적에 나온 View나 모듈을 찾습니다. **Reports** > **Recent log messages**를 열고 추적에 나온 View나 모듈을 찾습니다. 2. 해당 View를 수정하거나 삭제하고, 해당 모듈을 비활성화합니다. 3. 모든 캐시를 지웁니다. ## 하나의 콘텐츠 유형에 에디터가 표시되지 않습니다 1. 다음으로 이동합니다. **Structure** > **Content types** > (유형) > **Manage display**로 이동합니다. 2. 빌더 필드의 형식을 **DXPR Builder**로 설정합니다. 3. 다음뿐만 아니라 필드를 렌더링하는 모든 보기 모드에 반복합니다. **Default**뿐만 아니라 필드를 렌더링하는 모든 보기 모드에 반복합니다. **Note:** 에디터에는 값을 가진 필드가 연결 대상으로 필요합니다. 노드를 저장하면 DXPR Builder가 **DXPR Builder** 형식을 쓰는 빈 필드를 **Default**디스플레이에서 채웁니다. 형식을 바꾸기 전에 저장한 노드는 비어 있습니다. 한 번 편집하고 저장합니다. ## 일부 사용자에게만 에디터가 표시됩니다 에디터가 보이지 않는 계정에 대해 다음을 확인합니다. 1. 다음에서 역할에 권한이 있습니다. **People** > **Permissions**(`/admin/people/permissions`)에서 역할에 **Edit with DXPR Builder**가 있습니다. 2. 역할은 해당 콘텐츠도 편집할 수 있어야 합니다(예: **Basic page: Edit any content**). 페이지를 업데이트할 수 있는 사용자에게만 에디터가 로드됩니다. 3. 계정에 유효한 이메일 주소가 있습니다. 라이선스에 필요합니다. 4. 사용자 편집 양식에서 **Exclude from DXPR builder editing**이 체크되어 있지 않습니다. 5. 다음에서 해당 역할의 프로필에 체크가 되어 있습니다. **DXPR Studio** > **DXPR Builder** > **User Profiles**에서 해당 역할의 프로필에 **Start editor when page loads**가 체크되어 있습니다. 꺼져 있으면 컨테이너 컨트롤의 눈 아이콘을 클릭해야 컨트롤이 표시됩니다. ## 다른 에디터가 콘텐츠를 잠갔습니다 다음 경고가 동료와 함께 표시되고 컨테이너에는 버튼만 표시됩니다. "The content ... is locked by"라는 경고가 동료와 함께 표시되고 컨테이너에는 **Locked** 버튼만 표시됩니다. 해당 에디터가 컨테이너를 클릭하고 아직 저장하지 않았습니다. 저장하면 잠금이 해제됩니다. 저장을 요청하거나 **Locked**를 클릭하고 확인하여 인계받습니다. 둘 다 계속 편집하면 마지막 저장이 우선합니다. ## 수정 확인하기 비공개 창에서 다시 로드하고 콘텐츠 영역을 가리킵니다. 컨테이너 표시줄에 **View mode**, **More**, **Save**가 표시되고 콘솔에 빨간색 오류가 없습니다. ## 다음 단계 [Problems after updating](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)은 릴리스 직후 에디터가 깨졌을 때 확인합니다.