Mypy cannot find component event methods before the first Gradio import
该报错通常发生在升级 Gradio 后、首次运行 mypy 静态检查时，原因是组件存根文件（*.pyi）未被打包进 wheel。优先确认 wheel 中是否存在 gradio/components/button.pyi，以及在构建前是否执行过 python -c "import gradio" 。
标签： Python
[BUG] Getting-started docs reference retired Gemini model ids that return 404
![[BUG] Getting-started docs reference retired Gemini model ids that return 404](https://www.chat-gpts.plus/wp-content/uploads/2026/09/7002-f87053d5-768x403.jpg)
这是 CrewAI 官方文档中的 Gemini 模型 ID 已失效问题，用户复制教程中的模型 ID 调用 Gemini API 时返回 HTTP 404。优先排查你使用的模型 ID 是否为 gemini-2.0-flash 、 gemini-2.0-flash-001 或 gemini-2.5-fl
ValueError: Invalid content item type: file. Expected str or dict with ‘type’ field (text, image_url, tool_use, tool_result, thinking).
该报错发生在 LiteLLM 的 trim_messages 或 token 计数流程中，当消息内容包含 file 类型块（如 PDF 附件）时，token_counter 无法识别该类型并抛出 ValueError 。优先确认 LiteLLM 版本是否已升级到包含修复（#38997）的版本，并暂时
RuntimeError: Worker failed with error ‘Assertion error
该报错通常发生在 NVIDIA GB10（sm_121 架构）设备上尝试启动 DeepSeek-V4 模型时，vLLM 检测到 DeepGEMM 可用但没有正确的架构判断，导致在编译内核中触发断言错误。优先排查是否通过环境变量或补丁正确限制了 DeepGEMM 在 sm_121 上的启用。
[Bug]: vLLM hangs after NCCL init with TP=2 on Blackwell GPUs (CUDA 13.0, NCCL 2.27.7)
![[Bug]: vLLM hangs after NCCL init with TP=2 on Blackwell GPUs (CUDA 13.0, NCCL 2.27.7)](https://www.chat-gpts.plus/wp-content/uploads/2026/09/33041-30149f9a-768x403.jpg)
该报错是 vLLM 在使用张量并行（TP=2）初始化 NCCL 后卡死，常见于 Blackwell 架构 GPU（如 RTX PRO 6000、RTX 5090、B300）且未启用 NVLink、依赖 PCIe 通信的场景。优先排查 BIOS 中的 IOMMU / ACS 是否开启，并尝试禁用 P2
ImportError: cannot import name ‘ENABLE_LOCAL_WEB_FETCH’ from partially initialized module ‘open_webui.config’ (most likely due to a circular import) (/home/ricardo/IAI/owui/open-webui/backend/
该报错通常发生在 Open WebUI 通过 Git Clone 方式全新安装或升级时，Alembic 迁移因循环导入而静默失败，导致数据库表结构不完整。优先排查是否因新版本新增的 import 链引发了 config.py 的循环导入，并尝试手动执行数据库迁移。
bug: Fast UI missing trace input/output and do not show trace id explicitly
该报错通常出现在 Langfuse Fast UI 查看旧 Trace 时，表现为输入/输出/元数据缺失，且顶部只显示 observation id 而非 trace id。优先排查是否使用了旧版 Python SDK（v3），并升级到最新 SDK 版本。
Consider migrating from httpx to httpx2
该报错/问题发生在使用 OpenAI Python SDK 时，底层 HTTP 客户端 httpx 自 2024 年起停止维护，社区建议迁移至由 Pydantic Services Inc. 维护的 httpx2。优先排查方式：将 openai Python SDK 升级到 v3.0.0 或更高版本
TypeError: Cannot read properties of undefined (reading ‘chats’)`.
该报错发生在 RAGFlow 通过 Docker Compose 启动时，Infinity 冷启动重放元数据超过 120 秒导致主 API 服务初始化失败。优先排查方向是 docker/entrypoint.sh 中主 Web 服务循环未加 || true 保护，被 set -e 静默终止且不会自动
[Bug]: litellm stops forwarding model requests
![[Bug]: litellm stops forwarding model requests](https://www.chat-gpts.plus/wp-content/uploads/2026/08/38731-ee69185b-768x403.jpg)
该报错通常发生在 LiteLLM Proxy 网关空闲超过 24 小时后恢复使用时，已过期的临时密钥触发删除流程，产生 404: {'error': 'No keys found'} 异常循环，最终导致代理停止转发模型请求。优先排查密钥过期清理逻辑与删除流程中的异常处理。