# 문제 해결
자주 발생하는 Webflow 앱, 삽입, 미리 보기, 게시 문제를 진단하세요.

먼저 문제가 발생한 경계를 찾으세요. 원본 파일, 앱 미리 보기, 선택한 Webflow 요소, 생성된 런타임, 스테이징 사이트, 프로덕션 사이트 중 어디에서 처음 문제가 나타나는지 확인합니다.

| 증상                          | 확인 사항                                                          |
| --------------------------- | -------------------------------------------------------------- |
| Workspace가 비어 있음            | LottieFiles 계정, 활성 워크스페이스, 프로젝트 권한 확인                          |
| Insert animation이 요소 선택을 요청 | 준비한 미리 보기를 닫지 말고 페이지 요소를 선택한 뒤 다시 시도                           |
| 선택한 요소에 플레이어를 넣을 수 없음       | Div block처럼 자식 요소를 포함할 수 있는 컨테이너 사용                            |
| 네이티브 애니메이션이 보이지 않음          | Webflow Assets와 Navigator의 새 Lottie 요소 확인                      |
| 고급 플레이어가 캔버스에서 정지 이미지로만 보임  | 캔버스 썸네일이므로 Preview와 스테이징에서 실제 컴포넌트 테스트                         |
| 미리 보기가 비어 있음                | 고급 파일에는 Automatic 또는 ThorVG Player를 사용하고 페이지 사용자 지정 코드가 있는지 확인 |
| 테마가 바뀌지 않음                  | 삽입 결과가 테마가 고정된 네이티브 JSON인지 고급 런타임 테마인지 확인                      |
| 상태 머신이 반응하지 않음              | 올바른 상태 머신 ID와 유효한 컨테이너를 확인하고 Preview 또는 게시된 URL에서 테스트          |
| 스테이징은 바뀌었지만 프로덕션은 이전 상태     | 프로덕션 도메인에 게시하고 올바른 도메인을 선택했는지 확인                               |
| Workspace 업데이트가 반영되지 않음     | 업데이트는 자동 동기화되지 않으므로 Webflow 요소를 다시 삽입하거나 교체                    |

## 고급 기능 문제 분리

1. 기존 페이지나 요소를 대체 경로로 유지합니다.
2. 단순한 무료 단일 애니메이션 파일을 기본 설정으로 삽입합니다.
3. 정상적으로 동작하면 dotLottie v2, 테마, 멀티 애니메이션, 상태 머신을 하나씩 다시 적용합니다.
4. 의미 있는 변경을 할 때마다 `webflow.io` 스테이징 도메인에 게시합니다.

## 도움받기

앱 계정 메뉴와 LottieFiles 지원 자료를 사용해 버그를 신고하세요. Webflow 사이트 문맥, 원본 형식, 삽입 방식, 선택한 요소 형식, 문제가 Preview와 스테이징 또는 프로덕션 중 어디에서 나타나는지 함께 적습니다.

## 관련 문서

- [호환성 및 제한](/ko/integrations/webflow/06_reference/compatibility-and-limitations)
- [사이트 게시](/ko/integrations/webflow/05_insert-and-publish/publishing-your-site)
