# Figma to Lottie 문제 해결
Figma to Lottie 렌더링 failure, 예상과 다른 output, 빠진 interactivity를 해결합니다.

대부분의 Figma to Lottie 문제는 Figma 장면과 converter가 Lottie 출력물로 안정적으로 바꿀 수 있는 것 사이의 불일치에서 옵니다.

## 렌더링 fails

다음을 확인하세요.

- 지원되지 않는 Figma 기능.
- 프레임 사이 누락되거나 순서가 바뀐 레이어.
- 깔끔하게 변환되지 않는 컴포넌트 instance 또는 external library color.
- 하나의 object에 겹친 fills, gradients, strokes, shadows, effects.
- 같은 matched 텍스트 레이어 안의 text 변화.

## 애니메이션이 Figma 프로토타입과 다르게 보임

일부 Figma 전환 동작은 Lottie 출력물에 맞게 근사됩니다. 스프링 기반 easing은 약간 다르게 느껴질 수 있고, Smart Animate가 아닌 전환은 타이밍은 유지하지만 정확한 시각적 동작은 유지하지 못할 수 있으며, 렌더러 차이가 gradient나 effect에 영향을 줄 수 있습니다.

## 상태 머신을 사용할 수 없음

프로토타입이 지원되지 않는 인터랙션 또는 액션을 사용할 수 있습니다. 인터랙티브 내보내기가 필요하다면 back, close overlay, open overlay, swap overlay, scroll to, URL 액션 같은 지원되지 않는 액션을 지원되는 내비게이션 방식 전환으로 바꾸세요.

## Click 또는 hover가 작동하지 않음

다음을 확인하세요.

- 인터랙티브 element가 group만이 아니라 프레임입니다.
- 인터랙티브 레이어가 인터랙션을 받을 수 있을 만큼 보이는 상태합니다.
- 내보낸 애니메이션에서 레이어 이름이 맞습니다.
- `.lottie`로 내보냈습니다.
- 앱이 `lottie-web`이 아니라 dotLottie 런타임을 사용합니다.

## Text 변경이 렌더링 failure를 일으킴

같은 matched 텍스트 레이어 안에서 프레임마다 text content를 바꾸지 마세요. 각 text value마다 별도 텍스트 레이어를 만들고 visibility를 전환하세요.

## Gradient 또는 effect가 잘못 렌더링됨

단순한 gradient를 사용하고 duplicate 또는 stacked gradient fill을 피하세요. Angular와 diamond gradient는 내보내기에 안정적이지 않습니다.

## 관련 문서

- [Figma 장면 준비](preparing-your-figma-scene)
- [내보내기 경고 읽기](../06_feature-checking/reading-export-warnings)
- [지원되는 Figma 기능](../06_feature-checking/supported-figma-features)