async_config_entry_first_refresh in update coordinator requires a config entry (home-assistant#154114)

Author: gjohansson-ST

homeassistant/helpers/update_coordinator.py

@@ -300,12 +300,11 @@ async def async_config_entry_first_refresh(self) -> None:
         to ensure that multiple retries do not cause log spam.
         """
         if self.config_entry is None:
-            report_usage(
-                "uses `async_config_entry_first_refresh`, which is only supported "
-                "for coordinators with a config entry",
-                breaks_in_ha_version="2025.11",
+            raise ConfigEntryError(
+                "Detected code that uses `async_config_entry_first_refresh`,"
+                " which is only supported for coordinators with a config entry"
             )
-        elif (
+        if (
             self.config_entry.state
             is not config_entries.ConfigEntryState.SETUP_IN_PROGRESS
         ):

tests/helpers/test_update_coordinator.py

@@ -663,10 +663,9 @@ async def test_async_config_entry_first_refresh_no_entry(hass: HomeAssistant) ->
     crd = get_crd(hass, DEFAULT_UPDATE_INTERVAL, None)
     crd.setup_method = AsyncMock()
     with pytest.raises(
-        RuntimeError,
-        match="Detected code that uses `async_config_entry_first_refresh`, "
-        "which is only supported for coordinators with a config entry. "
-        "Please report this issue",
+        ConfigEntryError,
+        match="Detected code that uses `async_config_entry_first_refresh`,"
+        " which is only supported for coordinators with a config entry",
     ):
         await crd.async_config_entry_first_refresh()