> For the complete documentation index, see [llms.txt](https://docs.fleaflet.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fleaflet.dev/v3/faqs/map-controller-issues.md).

# Map Controller Issues

{% hint style="success" %}
These issues appear significantly less after v2.1.0, due to the reworking of the `MapController` lifecycle.

If you are experiencing these errors, please consider updating to this version or later.
{% endhint %}

This class of errors is usually caused by mis-configuring `MapController`s (see [Controller](/v3/usage/controller.md)), or using them in complex layouts. 

If you're having these issues - which can manifest as `LateInitializationError`s and/or `BadState` errors - there are a few things you can try to help out:

* Fully read the [Controller](/v3/usage/controller.md) page, and choose the right implementation/usage for your situation.
* In complex layouts, such as with `PageView`s or `ListView`s, use the [Recommended Options](/v3/usage/options/recommended-options.md#keep-alive-keepalive) property.
* If sharing the map controller, for example through `Provider`, make sure that the shared controller is initialised and destroyed/uninitialised at the same time as the `FlutterMap`.