What causes "close_door_failed" in home-assistant/core?

home-assistant/core · error · HomeAssistantError

close_door_failed

close_door_failed

Error message

close_door_failed

What it means

HomeAssistantError with translation_key 'close_door_failed' raised by AladdinConnectCover.async_close_cover when client.close_door() fails with aiohttp.ClientError. Identical mechanism to open_door_failed but for the close command; message text comes from strings.json and the original exception is preserved as the cause.

Source

Thrown at homeassistant/components/aladdin_connect/cover.py:72

    @override
    async def async_open_cover(self, **kwargs: Any) -> None:
        """Issue open command to cover."""
        try:
            await self.client.open_door(self._device_id, self._number)
        except aiohttp.ClientError as err:
            raise HomeAssistantError(
                translation_domain=DOMAIN,
                translation_key="open_door_failed",
            ) from err

    @override
    async def async_close_cover(self, **kwargs: Any) -> None:
        """Issue close command to cover."""
        try:
            await self.client.close_door(self._device_id, self._number)
        except aiohttp.ClientError as err:
            raise HomeAssistantError(
                translation_domain=DOMAIN,
                translation_key="close_door_failed",
            ) from err

    @property
    @override
    def is_closed(self) -> bool | None:
        """Update is closed attribute."""
        if (status := self.door.status) is None:
            return None
        return status == "closed"

    @property
    @override
    def is_closing(self) -> bool | None:
        """Update is closing attribute."""
        return self.door.status == "closing"

View on GitHub (pinned to 58a3fdb3ea)

Solutions

Retry the close command.
Inspect logs for the underlying ClientError; re-auth if it is token-related.
Confirm the door works from the official app.
Handle HomeAssistantError in automations to alert the user.

Defensive patterns

Strategy: try-catch

Try / catch

try:
    await cover.async_close_cover()
except HomeAssistantError as err:
    _LOGGER.error("Close failed: %s (cause: %r)", err, err.__cause__)

Prevention

Retry close commands on transient cloud errors.
Distinguish API failure from physical blockage (state stays open without exception).
Inspect __cause__ for auth vs. network classification.

When it happens

Trigger: cover.close_cover command whose cloud request fails at the transport layer or with an HTTP error.

Common situations: Cloud outage; network drop; safety sensors blocking the physical close is NOT this error (that shows as door reopening in state), only API transport/HTTP failures raise here.

Related errors

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/efa2da1a4264144d. Report an issue: GitHub.