riverpod-ref-read-in-dispose

name	riverpod-ref-read-in-dispose
description	Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget. Use when: (1) Error thrown in dispose() when calling ref.read(), (2) Need to call a service method during widget cleanup, (3) ConsumerStatefulWidget needs to perform actions on provider when user navigates away. Solution: cache the service/notifier in initState with late final.
author	Claude Code
version	1.0.0
date	"2026-02-01T00:00:00.000Z"

Riverpod ref.read() in dispose() Error

Problem

When a ConsumerStatefulWidget needs to call a service method in dispose() (e.g., to cancel an operation when the user leaves a screen), using ref.read() throws an error because the widget is already unmounted.

Context / Trigger Conditions

• Error message: Using ref when widget is unmounted is unsafe
• Using ConsumerStatefulWidget with ConsumerState
• Calling ref.read(someProvider) inside dispose()
• Widget navigates away (pop, push replacement, etc.)
• Stack trace shows the error originating from dispose()