문제 해결

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

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

고급 기능 문제 분리

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