Detected blocking call to listdir with args ('/config/.storage/stellantis_vehicles',) inside the event loop by custom integration

[squadramunter]

Mark

Opel

Model

202

Year

2021

Engine

Electric

Remote service

E-remote control

HomeAssistant version

2025.11.1

Integration version

2025.11.3

What happened?

For some reason this addon is generating huge amount of error logging and I have no idea what this could be.

This is the error what I grabbed from my logging.

Log output

�[33m2025-11-12 10:20:12.474 WARNING (MainThread) [homeassistant.util.loop] Detected blocking call to listdir with args ('/config/.storage/stellantis_vehicles',) inside the event loop by custom integration 'stellantis_vehicles' at custom_components/stellantis_vehicles/__init__.py, line 89: ? (offender: /config/custom_components/stellantis_vehicles/__init__.py, line 89: ?), please create a bug report at https://github.com/andreadegiovine/homeassistant-stellantis-vehicles/issues
For developers, please see https://developers.home-assistant.io/docs/asyncio_blocking_operations/#listdir
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 229, in <module>
    sys.exit(main())
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 215, in main
    exit_code = runner.run(runtime_conf)
  File "/usr/src/homeassistant/homeassistant/runner.py", line 289, in run
    return loop.run_until_complete(setup_and_run_hass(runtime_config))
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 712, in run_until_complete
    self.run_forever()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 683, in run_forever
    self._run_once()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 2050, in _run_once
    handle._run()
  File "/usr/local/lib/python3.13/asyncio/events.py", line 89, in _run
    self._context.run(self._callback, *self._args)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 598, in start
    task = asyncio.Task(coro, loop=loop, eager_start=True)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 510, in _handle_request
    resp = await request_handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_app.py", line 569, in _handle
    return await handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_middlewares.py", line 117, in impl
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/security_filter.py", line 92, in security_filter_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/forwarded.py", line 214, in forwarded_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/request_context.py", line 26, in request_context_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/ban.py", line 86, in ban_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/auth.py", line 242, in auth_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/headers.py", line 41, in headers_middleware
    response = await handler(request)
  File "/usr/src/homeassistant/homeassistant/helpers/http.py", line 73, in handle
    result = await handler(request, **request.match_info)
  File "/usr/src/homeassistant/homeassistant/components/config/config_entries.py", line 116, in delete
    result = await hass.config_entries.async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2105, in async_remove
    unload_success, entry = await self._async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2128, in _async_remove
    await entry.async_remove(self.hass)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1034, in async_remove
    await component.async_remove_entry(hass, self)
  File "/config/custom_components/stellantis_vehicles/__init__.py", line 89, in async_remove_entry
�[0m
�[33m2025-11-12 10:20:12.497 WARNING (MainThread) [homeassistant.util.loop] Detected blocking call to scandir with args (25,) inside the event loop by custom integration 'stellantis_vehicles' at custom_components/stellantis_vehicles/__init__.py, line 91: ? (offender: /usr/local/lib/python3.13/shutil.py, line 682: with os.scandir(topfd) as scandir_it:), please create a bug report at https://github.com/andreadegiovine/homeassistant-stellantis-vehicles/issues
For developers, please see https://developers.home-assistant.io/docs/asyncio_blocking_operations/#scandir
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 229, in <module>
    sys.exit(main())
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 215, in main
    exit_code = runner.run(runtime_conf)
  File "/usr/src/homeassistant/homeassistant/runner.py", line 289, in run
    return loop.run_until_complete(setup_and_run_hass(runtime_config))
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 712, in run_until_complete
    self.run_forever()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 683, in run_forever
    self._run_once()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 2050, in _run_once
    handle._run()
  File "/usr/local/lib/python3.13/asyncio/events.py", line 89, in _run
    self._context.run(self._callback, *self._args)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 598, in start
    task = asyncio.Task(coro, loop=loop, eager_start=True)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 510, in _handle_request
    resp = await request_handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_app.py", line 569, in _handle
    return await handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_middlewares.py", line 117, in impl
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/security_filter.py", line 92, in security_filter_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/forwarded.py", line 214, in forwarded_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/request_context.py", line 26, in request_context_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/ban.py", line 86, in ban_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/auth.py", line 242, in auth_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/headers.py", line 41, in headers_middleware
    response = await handler(request)
  File "/usr/src/homeassistant/homeassistant/helpers/http.py", line 73, in handle
    result = await handler(request, **request.match_info)
  File "/usr/src/homeassistant/homeassistant/components/config/config_entries.py", line 116, in delete
    result = await hass.config_entries.async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2105, in async_remove
    unload_success, entry = await self._async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2128, in _async_remove
    await entry.async_remove(self.hass)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1034, in async_remove
    await component.async_remove_entry(hass, self)
  File "/config/custom_components/stellantis_vehicles/__init__.py", line 91, in async_remove_entry
�[0m
�[33m2025-11-12 10:20:12.528 WARNING (MainThread) [homeassistant.util.loop] Detected blocking call to listdir with args ('/config/www/stellantis-vehicles',) inside the event loop by custom integration 'stellantis_vehicles' at custom_components/stellantis_vehicles/__init__.py, line 101: ? (offender: /config/custom_components/stellantis_vehicles/__init__.py, line 101: ?), please create a bug report at https://github.com/andreadegiovine/homeassistant-stellantis-vehicles/issues
For developers, please see https://developers.home-assistant.io/docs/asyncio_blocking_operations/#listdir
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 229, in <module>
    sys.exit(main())
  File "/usr/src/homeassistant/homeassistant/__main__.py", line 215, in main
    exit_code = runner.run(runtime_conf)
  File "/usr/src/homeassistant/homeassistant/runner.py", line 289, in run
    return loop.run_until_complete(setup_and_run_hass(runtime_config))
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 712, in run_until_complete
    self.run_forever()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 683, in run_forever
    self._run_once()
  File "/usr/local/lib/python3.13/asyncio/base_events.py", line 2050, in _run_once
    handle._run()
  File "/usr/local/lib/python3.13/asyncio/events.py", line 89, in _run
    self._context.run(self._callback, *self._args)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 598, in start
    task = asyncio.Task(coro, loop=loop, eager_start=True)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_protocol.py", line 510, in _handle_request
    resp = await request_handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_app.py", line 569, in _handle
    return await handler(request)
  File "/usr/local/lib/python3.13/site-packages/aiohttp/web_middlewares.py", line 117, in impl
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/security_filter.py", line 92, in security_filter_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/forwarded.py", line 214, in forwarded_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/request_context.py", line 26, in request_context_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/ban.py", line 86, in ban_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/auth.py", line 242, in auth_middleware
    return await handler(request)
  File "/usr/src/homeassistant/homeassistant/components/http/headers.py", line 41, in headers_middleware
    response = await handler(request)
  File "/usr/src/homeassistant/homeassistant/helpers/http.py", line 73, in handle
    result = await handler(request, **request.match_info)
  File "/usr/src/homeassistant/homeassistant/components/config/config_entries.py", line 116, in delete
    result = await hass.config_entries.async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2105, in async_remove
    unload_success, entry = await self._async_remove(entry_id)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 2128, in _async_remove
    await entry.async_remove(self.hass)
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1034, in async_remove
    await component.async_remove_entry(hass, self)
  File "/config/custom_components/stellantis_vehicles/__init__.py", line 101, in async_remove_entry

[squadramunter]

From Gemmini I got this answer. I don't know if this is some helpful information.

3. The Required Fix

For the developer to resolve this warning, the blocking I/O calls must be run using Home Assistant's thread pool executor.

Instead of calling synchronous functions directly (e.g., os.listdir(path) or shutil.rmtree(path)), the developer needs to wrap them using:
Python

await hass.async_add_executor_job(
functools.partial(sync_function, path)
)

For instance, the deletion of the persistent folder (Line 91, involving scandir) would need to use shutil.rmtree wrapped in the executor job to become fully asynchronous.

[andreadegiovine]

Hi @squadramunter
I can't replicate the bug in my HASS instance, can you tell me the steps?

[squadramunter]

It appears that when it attempted to delete or remove the stellantis_vehicles configuration entry, the integration tried to clean up its files (.storage and www folders) using functions that are not properly asynchronous (e.g., they didn't use HA's hass.async_add_executor_job or similar methods to run the I/O in a separate thread).