[错误报告] 无法连接到最新版本（5.2）qBittorrent

[JKSTAFF]

确认

• 我的版本是最新版本，我的版本号与 version 相同。
• 我已经查阅了已知问题，并确认我的问题不在其中。
• 我已经 issue 中搜索过，确认我的问题没有被提出过。
• 我已经修改标题，将标题中的 描述 替换为我遇到的问题。

当前程序版本

3.2.6

问题类型

其他问题

问题描述

2026年5月4日qbtorrent官方镜像更新至5.2后，ab就无法连接到下载客户端了。
作为参照在ab 3.2.6和qb回滚至 5.1情况下工作正常，基本可排除应用的配置和网络环境问题

发生问题时系统日志

[2026-05-07 20:03:03] INFO:     INFO::uvicorn.error:Started server process [7]
[2026-05-07 20:03:03] INFO:     INFO::uvicorn.error:Waiting for application startup.
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:               _        ____                                    _
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:    /\        | |      |  _ \                                  (_)
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:   /  \  _   _| |_ ___ | |_) | __ _ _ __   __ _ _   _ _ __ ___  _
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:  / /\ \| | | | __/ _ \|  _ < / _` | '_ \ / _` | | | | '_ ` _ \| |
[2026-05-07 20:03:03] INFO:     INFO::module.core.program: / ____ \ |_| | || (_) | |_) | (_| | | | | (_| | |_| | | | | | | |
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:/_/    \_\__,_|\__\___/|____/ \__,_|_| |_|\__, |\__,_|_| |_| |_|_|
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:                                           __/ |
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:                                          |___/
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:Version 3.2.6  Author: EstrellaXD Twitter: https://twitter.com/Estrella_Pan
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:GitHub: https://github.com/EstrellaXD/Auto_Bangumi/
[2026-05-07 20:03:03] INFO:     INFO::module.core.program:Starting AutoBangumi...
[2026-05-07 20:03:03] INFO:     INFO::module.conf.config:Config loaded
[2026-05-07 20:03:03] INFO:     INFO::uvicorn.error:Application startup complete.
[2026-05-07 20:03:03] INFO:     INFO::uvicorn.error:Uvicorn running on http://0.0.0.0:7892 (Press CTRL+C to quit)
[2026-05-07 20:03:03] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:08] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:13] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:14] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:18] ERROR     ERROR:module.downloader.download_client:[Downloader] Auth failed.
[2026-05-07 20:03:18] ERROR     ERROR:module.checker.checker:[Checker] Downloader connect failed: Download client authentication failed
[2026-05-07 20:03:18] WARNING:  WARNING::module.core.program:Downloader is not running. (attempt 1/10)
[2026-05-07 20:03:18] INFO:     INFO::module.core.program:Waiting for downloader to start...
[2026-05-07 20:03:19] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:24] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.
[2026-05-07 20:03:29] ERROR     ERROR:module.downloader.download_client:[Downloader] Auth failed.
[2026-05-07 20:03:29] ERROR     ERROR:uvicorn.error:Exception in ASGI application
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/uvicorn/protocols/http/h11_impl.py", line 410, in run_asgi
    result = await app(  # type: ignore[func-returns-value]
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        self.scope, self.receive, self.send
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/app/.venv/lib/python3.13/site-packages/uvicorn/middleware/proxy_headers.py", line 60, in __call__
    return await self.app(scope, receive, send)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/app/.venv/lib/python3.13/site-packages/fastapi/applications.py", line 1135, in __call__
    await super().__call__(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/applications.py", line 107, in __call__
    await self.middleware_stack(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/middleware/errors.py", line 186, in __call__
    raise exc
  File "/app/.venv/lib/python3.13/site-packages/starlette/middleware/errors.py", line 164, in __call__
    await self.app(scope, receive, _send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/middleware/cors.py", line 85, in __call__
    await self.app(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/middleware/exceptions.py", line 63, in __call__
    await wrap_app_handling_exceptions(self.app, conn)(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/_exception_handler.py", line 53, in wrapped_app
    raise exc
  File "/app/.venv/lib/python3.13/site-packages/starlette/_exception_handler.py", line 42, in wrapped_app
    await app(scope, receive, sender)
  File "/app/.venv/lib/python3.13/site-packages/fastapi/middleware/asyncexitstack.py", line 18, in __call__
    await self.app(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/routing.py", line 716, in __call__
    await self.middleware_stack(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/routing.py", line 736, in app
    await route.handle(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/routing.py", line 290, in handle
    await self.app(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/fastapi/routing.py", line 115, in app
    await wrap_app_handling_exceptions(app, request)(scope, receive, send)
  File "/app/.venv/lib/python3.13/site-packages/starlette/_exception_handler.py", line 53, in wrapped_app
    raise exc
  File "/app/.venv/lib/python3.13/site-packages/starlette/_exception_handler.py", line 42, in wrapped_app
    await app(scope, receive, sender)
  File "/app/.venv/lib/python3.13/site-packages/fastapi/routing.py", line 101, in app
    response = await f(request)
               ^^^^^^^^^^^^^^^^
  File "/app/.venv/lib/python3.13/site-packages/fastapi/routing.py", line 355, in app
    raw_response = await run_endpoint_function(
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    ...<3 lines>...
    )
    ^
  File "/app/.venv/lib/python3.13/site-packages/fastapi/routing.py", line 243, in run_endpoint_function
    return await dependant.call(**values)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/app/module/api/downloader.py", line 32, in get_torrents
    async with DownloadClient() as client:
               ~~~~~~~~~~~~~~^^
  File "/app/module/downloader/download_client.py", line 55, in __aenter__
    raise ConnectionError("Download client authentication failed")
ConnectionError: Download client authentication failed
[2026-05-07 20:03:48] ERROR     ERROR:module.downloader.client.qb_downloader:Can't login qBittorrent Server http://127.0.0.1:6880 by admin, retry in 5 seconds.

[Lamiszch]

用Claude找半天，应该是这个问题：
qBittorrent 从 5.2.0 开始修改了 /api/v2/auth/login 的返回值，登录成功不再返回 HTTP 200 + "Ok."，而是改为 HTTP 204 + 空body。
qb_downloader.py 里的判断逻辑只接受 200 + "Ok."：

python
if resp.status_code == 200 and resp.text == "Ok.":
    return True

简单改成兼容 204 即可修复：

python
if resp.status_code == 204 or (resp.status_code == 200 and resp.text == "Ok."):
     return True

本地 patch 这一行后重启容器，确认可以正常连接使用。

参考：qBittorrent 5.2.0 changelog —— WEBAPI: Send 204 when WebAPI response contains no data

[aptx4869god]

同理，对于新部署的小伙伴，在web UI初始设置qb的时候，如果qb是5.2版本，也会报错“认证失败：用户密码错误”。需要修改

Auto_Bangumi/backend/src/module/api/setup.py

Line 172 in 717ad11

message_zh="认证失败：用户名或密码错误。",

if login_resp.status_code == 200 and "ok" in login_resp.text.lower():
改为
if login_resp.status_code in (200, 204):

然后再重启docker compose即可

当然了，也可以回滚qb到5.1。