[Flutter] LateError (LateInitializationError: Field 'animationController' has not been initialized.)

💣 LateError (LateInitializationError: Field 'animationController' has not been initialized.)

👉 late 키워드로 선언된 animationController가 initState()에서 초기화되지 않았거나, 위젯이 사용되기 전에 초기화되지 않았을 때 발생한다.

🔍 원인

• AnimationController를 late로 선언했지만, initState()에서 초기화하지 않음.
• initState()에서 초기화했지만, super.initState(); 호출을 빼먹음.
• dispose()에서 animationController.dispose();을 호출하지 않아 문제가 발생.

✅ 해결 방법

• ① initState()에서 초기화 추가
  AnimationController는 반드시 initState()에서 초기화해야 한다.
  아래와 같이 vsync: this를 사용하여 SingleTickerProviderStateMixin을 추가하면 된다.

class _MyWidgetState extends State<MyWidget> with SingleTickerProviderStateMixin {
  late AnimationController animationController;

  @override
  void initState() {
    super.initState();
    
    // 🔹 AnimationController 초기화
    animationController = AnimationController(
      vsync: this,
      duration: const Duration(seconds: 2),
    );
  }

  @override
  void dispose() {
    // 🔹 AnimationController는 반드시 dispose()에서 정리
    animationController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Container();
  }
}

• ② 초기화를 즉시 하도록 late 대신 final 사용
  초기화를 late로 미루지 말고 final을 사용하면 안전하다.

class _MyWidgetState extends State<MyWidget> with SingleTickerProviderStateMixin {
  final AnimationController animationController;

  _MyWidgetState()
      : animationController = AnimationController(
          vsync: this,
          duration: const Duration(seconds: 2),
        );

  @override
  void dispose() {
    animationController.dispose();
    super.dispose();
  }
}

initState 추가 후, 오류가 사라진 것을 확인할 수 있었음!