issue: server appears stuck because open-webui serve stays in the foreground
该报错发生在通过 pip 方式安装 Open WebUI v0.11.1 后执行启动命令时，进程停留在前台无法正常提供服务。优先排查启动命令是否完整、模型下载是否正常完成，以及是否误将前台日志输出当成卡死。
标签： Python
ValueError: Unrecognized configuration class <class ‘transformers.models.gemma4.configuration_gemma4.Gemma4Config’>
该报错发生在调用 Gemma 4 模型执行序列分类任务（Sequence Classification）时，报错直接原因是代码中缺少 Gemma4Config / Gemma4ForSequenceClassification 类，导致 Transformers 无法正确识别配置。优先排查当前 Tr
Use python generator instead of streamer for generation
该报错通常出现在开发者希望用 Python 生成器（Generator）直接遍历 model.generate() 的逐 token 输出、而当前 Transformers 版本并未提供该语法时。优先排查是否安装了新版本 Transformers，并改用 AsyncTextIteratorStrea
No module named ‘flash_attn_2_cuda’
该报错发生在通过 ComfyUI-Manager 更新 ComfyUI 主程序时，核心原因是本地 Git 仓库缺少用户身份配置，导致 git pull 无法自动提交合并，从而报 “Committer identity unknown”。优先排查 Git 的 user.name 和 user.emai
TypeError: Server.streamable_http_app() got an unexpected keyword argument ‘session_idle_timeout’
该报错发生在通过 MCP Python SDK 的高级 API streamable_http_app() 配置会话空闲超时参数时，由于该参数未在高层接口中透传，导致函数调用直接抛出 TypeError。优先排查思路是检查是否使用了 StreamableHTTPSessionManager 手动构建
Rejected streamable-HTTP requests leave live sessions behind: the session is registered before the request is validated
该报错发生在 MCP Python SDK 的有状态 streamable-HTTP 模式下。当服务器拒绝请求（如 400/406/421）时，会话仍会在注册后才进行校验，导致未终止的会话残留。优先排查是否有会话清理机制，并考虑升级 SDK 版本。
Cleanly terminated streamable-HTTP sessions are never deregistered: the DELETE path skips its own cleanup
该报错发生在 MCP Python SDK 的 streamable-HTTP 握手路径中：客户端通过 DELETE 干净终止会话后，会话并未从 StreamableHTTPSessionManager._server_instances 注销，导致每终止一个会话就泄漏几 KB 内存。优先检查 St
[Feature]: Lakera v2 guardrail: advisory mode (inject_system_message) instead of block/monitor on flagged content
![[Feature]: Lakera v2 guardrail: advisory mode (inject_system_message) instead of block/monitor on flagged content](https://www.chat-gpts.plus/wp-content/uploads/2026/08/36552-c03e40ad-768x403.jpg)
这是 LiteLLM Proxy 中 Lakera v2 guardrail 的功能增强请求，并非运行报错。核心诉求是在 `on_flagged` 增加第三种动作：`inject_system_message`，在请求被标记时注入系统提示词而不是直接拦截或静默放行。优先排查当前 guardrail
[Bug]: prefix caching + MTP still corrupts output on hybrid Mamba/GDN models in v0.28.0 (#43559 closed but unfixed)
![[Bug]: prefix caching + MTP still corrupts output on hybrid Mamba/GDN models in v0.28.0 (#43559 closed but unfixed)](https://www.chat-gpts.plus/wp-content/uploads/2026/08/53912-c8b37e58-768x403.jpg)
在 v0.28.0 中，同时开启 `--enable-prefix-caching` 和 MTP 投机解码（`--speculative-config '{"method": "mtp", "num_speculative_tokens": 2}'`）时，混合 Mamba/GDN 模型（如 Qwen
issue: bug: reasoning blocks are not streamed
此问题出现在 Open WebUI v0.11.1 中，表现为思维链（reasoning）内容无法流式输出，必须刷新页面或切换会话才能看到不完整的推理块。优先排查是否使用了旧版本分支，更新到 dev 分支或最新版本通常可以解决。