testcontainers / testcontainers/testcontainers-python

Bug: `docker.errors.DockerException: Error while fetching server API version: maximum recursion depth exceeded` since upgrade of 4.15

Offen
#1,085 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
Python
Sterne
2.3k
Forks
386
Ø Merge
4 Std. 40 Min.
Gemergte PRs (30 T.)
1

Beschreibung

Describe the bug

It seems there is a regression after upgrading from 4.14.2 to 4.15

I was able to reproduce locally (podman) and on Kubernetes (via kubedock) and DOCKER_HOST='tcp://localhost:2475'

To Reproduce

def test_containers():
    with PostgresContainer(
        "<custom_domain>/postgres:16.4"
    ) as postgres:
        engine = sqlalchemy.create_engine(postgres.get_connection_url())
        with engine.begin() as connection:
            result = connection.execute(sqlalchemy.text("select version()"))
            (version,) = result.fetchone()
            client = TestClient(app)
            response = client.get("/api/todos/1")
            assert response.status_code == 200
            assert response.json() == {"completed": False, "id": 1, "title": "Todo 1"}
            response = client.get("/api/todos")
            assert response.status_code == 200

FAILED app/test_main.py::test_containers - docker.errors.DockerException: Error while fetching server API version: maximum recursion depth exceeded

Runtime environment

WSL podman but same behavior on kubedock (Docker API for K8S)

# Get the operating system information (on a unix os).
$ uname -a
 6.18.33.2-microsoft-standard-WSL2 #1
# Get the python version.
$ python --version
Python 3.14.5
# Get the docker version and other docker information.
$ docker info
version:
  APIVersion: 4.9.3
  Built: 0
  BuiltTime: Thu Jan  1 01:00:00 1970
  GitCommit: ""
  GoVersion: go1.22.2
  Os: linux
  OsArch: linux/amd64
  Version: 4.9.3
# Get all python packages.
$ pip freeze
annotated-doc==0.0.4
annotated-types==0.7.0
anyio==4.14.1
babel==2.18.0
backrefs==7.0
beautifulsoup4==4.12.3
certifi==2026.6.17
cfgv==3.5.0
charset-normalizer==3.4.9
click==8.4.1
colorama==0.4.6
coverage==7.15.0
dacite==1.9.2
defusedxml==0.7.1
distlib==0.4.3
docker==7.1.0
fastapi==0.139.2
filelock==3.29.7
ghp-import==2.1.0
gitdb==4.0.12
GitPython==3.1.50
greenlet==3.5.3
h11==0.16.0
httpcore==1.0.9
httpie==3.2.4
httpx==0.28.1
identify==2.6.19
idna==3.18
iniconfig==2.3.0
Jinja2==3.1.6
Markdown==3.10.2
markdown-it-py==4.2.0
markdown_graphviz_inline==1.1.3
MarkupSafe==3.0.3
mdurl==0.1.2
mdx-truly-sane-lists==1.3
mergedeep==1.3.4
mkdocs==1.6.1
mkdocs-autorefs==1.4.4
mkdocs-get-deps==0.2.2
mkdocs-git-latest-changes-plugin==0.0.23
mkdocs-github-admonitions-plugin==0.1.1
mkdocs-include-dir-to-nav==1.2.0
mkdocs-inline-svg-plugin==0.1.5
mkdocs-kroki-plugin==1.6.0
mkdocs-material==9.7.6
mkdocs-material-extensions==1.3.1
mkdocs-monorepo-plugin==1.1.2
mkdocs-multirepo-plugin==0.8.3
mkdocs-nav-weight==0.3.0
mkdocs-redirects==1.2.3
mkdocs-same-dir==0.1.5
mkdocs-techdocs-core==1.7.0
mkdocstrings==1.0.4
multidict==6.7.1
mypy_extensions==1.1.0
nodeenv==1.10.0
packaging==26.2
paginate==0.5.7
pathspec==1.1.1
plantuml-markdown==3.11.2
platformdirs==4.10.0
pluggy==1.6.0
pre_commit==4.6.1
properdocs==1.6.7
psycopg2-binary==2.9.12
pydantic==2.13.4
pydantic_core==2.46.4
Pygments==2.20.0
pymdown-extensions==10.21.3
PySocks==1.7.1
pytest==9.1.1
pytest-cov==7.1.0
python-dateutil==2.9.0.post0
python-discovery==1.4.3
python-dotenv==1.2.2
python-slugify==8.0.4
PyYAML==6.0.3
pyyaml_env_tag==1.1
requests==2.31.0
requests-toolbelt==1.0.0
result==0.17.0
rich==15.0.0
setuptools==83.0.0
six==1.17.0
smmap==5.0.3
soupsieve==2.8.4
SQLAlchemy==2.0.51
starlette==1.3.1
testcontainers==4.15.0
text-unidecode==1.3
typing-inspect==0.8.0
typing-inspection==0.4.2
typing_extensions==4.16.0
urllib3==2.7.0
uvicorn==0.51.0
virtualenv==21.6.0
watchdog==6.0.0
wrapt==2.2.2

On 4.14.2 no issue on both environment

On CI I was able to capture this stacktrace

[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:501: in _create_instance
[05:43:48.711+02:00] -     .start()
[05:43:48.711+02:00] -      ^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:247: in start
[05:43:48.711+02:00] -     Reaper.get_instance()
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:472: in get_instance
[05:43:48.711+02:00] -     Reaper._instance = Reaper._create_instance()
[05:43:48.711+02:00] -                        ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:495: in _create_instance
[05:43:48.711+02:00] -     DockerContainer(c.ryuk_image)
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/container.py:129: in __init__
[05:43:48.711+02:00] -     self._docker = DockerClient(**(docker_client_kw or {}))
[05:43:48.711+02:00] -                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.711+02:00] - ../../../.local/lib/python3.14/site-packages/testcontainers/core/docker_client.py:194: in __init__
[05:43:48.712+02:00] -     self.client = docker.from_env(**kwargs)
[05:43:48.712+02:00] -                   ^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.712+02:00] - ../../../.local/lib/python3.14/site-packages/docker/client.py:110: in from_env
[05:43:48.712+02:00] -     return cls(
[05:43:48.712+02:00] - ../../../.local/lib/python3.14/site-packages/docker/client.py:48: in __init__
[05:43:48.712+02:00] -     self.api = APIClient(*args, **kwargs)
[05:43:48.712+02:00] -                ^^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.712+02:00] - ../../../.local/lib/python3.14/site-packages/docker/api/client.py:207: in __init__
[05:43:48.712+02:00] -     self._version = self._retrieve_server_version()
[05:43:48.712+02:00] -                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[05:43:48.712+02:00] - _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 
[05:43:48.712+02:00] - 
[05:43:48.712+02:00] - self = <docker.api.client.APIClient object at 0x7f97b2161650>
[05:43:48.712+02:00] - 
[05:43:48.712+02:00] -     def _retrieve_server_version(self):
[05:43:48.712+02:00] -         try:
[05:43:48.712+02:00] -             return self.version(api_version=False)["ApiVersion"]
[05:43:48.712+02:00] -         except KeyError as ke:
[05:43:48.712+02:00] -             raise DockerException(
[05:43:48.712+02:00] -                 'Invalid response from docker daemon: key "ApiVersion"'
[05:43:48.712+02:00] -                 ' is missing.'
[05:43:48.712+02:00] -             ) from ke
[05:43:48.712+02:00] -         except Exception as e:
[05:43:48.712+02:00] - >           raise DockerException(
[05:43:48.712+02:00] -                 f'Error while fetching server API version: {e}'
[05:43:48.712+02:00] -             ) from e
[05:43:48.712+02:00] - E           docker.errors.DockerException: Error while fetching server API version: maximum recursion depth exceeded
[05:43:48.712+02:00] - 
[05:43:48.712+02:00] - ../../../.local/lib/python3.14/site-packages/docker/api/client.py:230: DockerException

Reaper._create_instance() seems to be called forever

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Untersuche zuerst testcontainers/core/container.py bei Reaper.get_instance(), _create_instance() und DockerContainer.init, und verfolge dann die Erstellung von DockerClient bis zu docker/api/client.py's _retrieve_server_version, das im Trace angezeigt wird. Reproduziere das Problem mit dem bereitgestellten test_containers-Beispiel und DOCKER_HOST; als erledigt gilt es, wenn der 4.15-Pfad nicht mehr rekursiv aufgerufen wird und die Regression abgedeckt ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
docker, python
Bereich
testing
Issue-Typ
Bug
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
58/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.