# 문제 해결
자주 발생하는 Framer 플러그인, 삽입, 미리 보기, 게시 문제를 진단하세요.

먼저 문제가 발생한 경계를 찾으세요. 원본 파일, 플러그인 미리 보기, Framer 컴포넌트, Framer Preview, 게시된 사이트 중 어디에서 처음 문제가 나타나는지 확인합니다.

| 증상                          | 확인 사항                                                        |
| --------------------------- | ------------------------------------------------------------ |
| Workspace가 비어 있음            | 로그인한 계정, 활성 워크스페이스, 프로젝트 권한 확인                               |
| 검색 결과가 없음                   | 세 글자 이상의 구체적인 검색어를 사용하고 충돌하는 Free/Premium 또는 소스 필터 해제        |
| 삽입해도 변화가 없음                 | 미리 보기가 모두 불러와졌는지 확인한 뒤 단순한 단일 애니메이션 파일로 다시 시도                |
| 컴포넌트가 잘못된 위치에 나타남           | 삽입 전에 대상 Frame을 선택한 뒤 Framer 컨트롤로 결과 이동                      |
| 애니메이션이 잘림                   | 모든 브레이크포인트에서 부모 Frame의 크기와 오버플로 확인                           |
| 미리 보기가 비어 있음                | Automatic 또는 ThorVG Player로 바꾸고 원본 URL에 계속 접근할 수 있는지 확인      |
| 테마가 바뀌지 않음                  | 파일에 선택한 테마 ID가 있고 ThorVG Player가 활성화되어 있는지 확인                |
| 상태 머신이 반응하지 않음              | 상태 머신 모드를 켜고 올바른 머신을 선택한 뒤 정적인 캔버스가 아니라 Framer Preview에서 테스트 |
| 플러그인 미리 보기는 되지만 실제 사이트에서 실패 | 다시 게시하고 실제 URL을 새 탭에서 연 뒤 플레이어 원본을 로그인 없이 불러올 수 있는지 확인       |
| Workspace 업데이트가 반영되지 않음     | 업데이트는 자동 동기화되지 않으므로 Framer 컴포넌트를 다시 삽입하거나 교체                 |

## 고급 기능 문제 분리

1. 페이지를 복제하거나 기존 컴포넌트를 대체 경로로 유지합니다.
2. 단순한 무료 단일 애니메이션 파일을 기본 설정으로 삽입합니다.
3. 정상적으로 동작하면 렌더러, 테마, 멀티 애니메이션 선택, 상태 머신을 하나씩 다시 적용합니다.
4. 의미 있는 변경을 할 때마다 스테이징에 게시합니다.

## 도움받기

플러그인 Help 메뉴에서 버그를 신고하세요. Framer 프로젝트 문맥, 원본 형식, 렌더러, 문제가 Preview와 게시 후 중 어디에서 나타나는지, 가능한 경우 비공개 정보가 없는 재현 방법을 함께 적습니다.

## 관련 문서

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