Ubuntu 24.04执行docker-compose up -d报chunked参数错误求助

问题环境与报错 #

环境：

• Ubuntu 24.04 LTS
• Python 3.12.3
• docker-compose 1.29.2

执行sudo docker-compose up -d时触发以下错误：

Traceback (most recent call last):
    File "/usr/lib/python3/dist-packages/docker/api/client.py", line 214, in _retrieve_server_version
    return self.version(api_version=False)["ApiVersion"]
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/docker/api/daemon.py", line 181, in version
    return self._result(self._get(url), json=True)
                        ^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/docker/utils/decorators.py", line 46, in inner
    return f(self, *args, **kwargs)
            ^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/docker/api/client.py", line 237, in _get
    return self.get(url, **self._set_request_timeout(kwargs))
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/requests/sessions.py", line 602, in get
    return self.request("GET", url, **kwargs)
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/requests/sessions.py", line 589, in request
    resp = self.send(prep, **send_kwargs)
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/requests/sessions.py", line 703, in send
    r = adapter.send(request, **kwargs)
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/requests/adapters.py", line 486, in send
    resp = conn.urlopen(
            ^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/urllib3/connectionpool.py", line 791, in urlopen
    response = self._make_request(
                ^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/urllib3/connectionpool.py", line 497, in _make_request
    conn.request(
TypeError: HTTPConnection.request() got an unexpected keyword argument 'chunked'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
    File "/usr/bin/docker-compose", line 33, in <module>
    sys.exit(load_entry_point('docker-compose==1.29.2', 'console_scripts', 'docker-compose')())
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 81, in main
    command_func()
    File "/usr/lib/python3/dist-packages/compose/cli/main.py", line 200, in perform_command
    project = project_from_options('.', options)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/compose/cli/command.py", line 60, in project_from_options
    return get_project(
            ^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/compose/cli/command.py", line 152, in get_project
    client = get_client(
                ^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/compose/cli/docker_client.py", line 41, in get_client
    client = docker_client(
                ^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/compose/cli/docker_client.py", line 170, in docker_client
    client = APIClient(use_ssh_client=not use_paramiko_ssh, **kwargs)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/docker/api/client.py", line 197, in __init__
    self._version = self._retrieve_server_version()
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3/dist-packages/docker/api/client.py", line 221, in _retrieve_server_version
    raise DockerException(
docker.errors.DockerException: Error while fetching server API version: HTTPConnection.request() got an unexpected keyword argument 'chunked'

原因分析 #

docker-compose 1.29.2是2021年发布的旧版本，完全不兼容Python 3.12。Python 3.12对标准库http.client的HTTPConnection.request()方法做了参数调整，移除了chunked参数的支持，但旧版本docker-compose依赖的urllib3和requests库仍在调用该参数，导致类型错误。

解决方法 #

方案1：升级到官方推荐的docker compose（最稳定） #

Docker官方已弃用旧的docker-compose独立工具，改用集成在Docker引擎中的docker compose命令（无横杠）：

1. 卸载旧版本docker-compose：

   sudo apt remove --purge docker-compose
   

2. 安装docker-compose-plugin：

   sudo apt update
   sudo apt install docker-compose-plugin
   

3. 验证安装：

   docker compose version
   

4. 执行原命令（注意去掉横杠）：

   sudo docker compose up -d
   

方案2：降级Python到兼容版本 #

如果必须使用docker-compose 1.29.2，可以降级Python到3.11或更低版本：

1. 安装Python 3.11：

   sudo apt install python3.11 python3.11-venv
   

2. 创建并激活虚拟环境：

   python3.11 -m venv ~/docker-compose-env
   source ~/docker-compose-env/bin/activate
   

3. 在虚拟环境中安装docker-compose 1.29.2：

   pip install docker-compose==1.29.2
   

4. 每次使用时先激活虚拟环境，再执行命令：

   source ~/docker-compose-env/bin/activate
   sudo docker-compose up -d
   

方案3：临时修复依赖库（不推荐） #

通过修改依赖库代码绕过错误，仅作为临时应急方案：

1. 编辑urllib3的connectionpool.py文件：

   sudo nano /usr/lib/python3/dist-packages/urllib3/connectionpool.py
   

2. 找到conn.request(所在行（约第497行），删除chunked=chunked,参数。
3. 保存退出后重新执行命令。

或者升级requests和urllib3到兼容Python3.12的版本：

sudo pip install --upgrade requests urllib3

内容的提问来源于stack exchange，提问作者Regan Aram