Werkzeug ClientDisconnected错误咨询：Ubuntu 18.04 VM环境异常排查

错误详情 #

遇到的错误提示：

werkzeug.exceptions.ClientDisconnected: 400 Bad Request: The browser (or proxy) sent a request that this server could not understand.

完整堆栈信息：

Traceback (most recent call last):
  File "/usr/local/lib/python3.10/site-packages/werkzeug/wsgi.py", line 921, in read
    read = self._read(to_read)
ValueError: read of closed file

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/usr/local/lib/python3.10/site-packages/werkzeug/formparser.py", line 140, in wrapper
    return f(self, stream, *args, **kwargs)
  File "/usr/local/lib/python3.10/site-packages/werkzeug/formparser.py", line 290, in _parse_multipart
    form, files = parser.parse(stream, boundary, content_length)
  File "/usr/local/lib/python3.10/site-packages/werkzeug/formparser.py", line 418, in parse
    for data in iterator:
  File "/usr/local/lib/python3.10/site-packages/werkzeug/wsgi.py", line 653, in _make_chunk_iter
    item = _read(buffer_size)
  File "/usr/local/lib/python3.10/site-packages/werkzeug/wsgi.py", line 923, in read
    return self.on_disconnect()
  File "/usr/local/lib/python3.10/site-packages/werkzeug/wsgi.py", line 893, in on_disconnect
    raise ClientDisconnected()
werkzeug.exceptions.ClientDisconnected: 400 Bad Request: The browser (or proxy) sent a request that this server could not understand.

环境对比 #

• 异常环境：Ubuntu 18.04虚拟机 + Python 3.10.5 + Werkzeug 2.1.2
• 正常环境：
  • Windows 10
  • Ubuntu 18.04 NUC
  • Ubuntu 18.04虚拟机 + Python 3.6.5 + Werkzeug 1.0.1

可能原因分析 #

• Werkzeug版本迭代的逻辑变化：Werkzeug 2.x对比1.x，在客户端连接断开时的错误处理逻辑更严格。旧版本可能对已关闭的请求流做了容错处理，新版本则直接抛出ClientDisconnected异常并映射为400错误。
• Python版本与Werkzeug的兼容性：Python 3.10在文件流状态检测、异常传播机制上有细节调整，和Werkzeug 2.x的交互逻辑与Python 3.6存在差异，触发了原本未暴露的错误路径。
• 虚拟机网络栈的稳定性问题：虚拟机的网络I/O可能存在延迟、丢包或数据流提前截断的情况，当Werkzeug尝试读取已中断的请求流时，新版本的严格检查直接判定为无效请求，而旧环境中这种情况被静默处理。
• 多部分表单解析的严格性提升：Werkzeug 2.x优化了multipart/form-data的解析流程，对输入流的完整性检查更苛刻，虚拟机环境中请求传输的微小异常会被放大为400错误，旧版本则具备更强的容错能力。

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