分类： AI 工具排错

AI 工具排错

Allow customization of the Starlette app (middleware, routes, etc)

这是一个功能请求，用户希望在 MCP Python SDK 的 SSE 服务器中自定义 Starlette 应用（添加中间件、路由等）。该功能已在 SDK v2 中得到支持（参见 PR #312）。如果仍在使用旧版，可能需要手动创建独立的 Starlette/FastAPI 服务器来集成 MCP S

celebrityanime
2026年 7月 30日

AI 工具排错

Unknown methods return -32602 Invalid params instead of -32601 Method not found

MCP Python SDK 对未知 JSON-RPC 方法错误地返回 -32602 Invalid params 而非正确的 -32601 Method not found ，导致客户端（如 Smithery）误判并反复重试。优先排查是否正在使用 v1.x 版 SDK，并升级到 v2.0.0。

celebrityanime
2026年 7月 30日

AI 工具排错

Gradio 6.20+: OSError: Cannot find empty port in range: 7861-7861.

该报错通常出现在 Gradio 6.20+ 在 Hugging Face Spaces 上启动时，提示端口 7861 不可用。优先尝试登出 Hugging Face 账户并重新登录，再重新构建 Space。

celebrityanime
2026年 7月 30日

AI 工具排错

[Bug]: CJK characters from concurrent requests bleed into unrelated streams (cross-request contamination in streaming)

该问题发生在多个并发请求通过 LiteLLM 代理进行流式输出时，CJK（中文）字符碎片会意外注入到无关的响应流或工具调用参数中。优先排查是否开启了 merge_reasoning_content_in_choices ，但该标志并非根本原因，当前没有确认的修复方案。

celebrityanime
2026年 7月 30日

AI 工具排错

[Bug]: MCP OAuth: persisted discovered issuer flips servers into issuer-anchored mode; one failed metadata fetch then breaks /authorize unti

在 LiteLLM Proxy 中使用交互式 OAuth2 MCP 服务器（指定了 authorization_url 、 token_url 和 registration_url 但 issuer 留空）时，系统会自动将发现的 issuer 持久化到数据库，导致服务器进入“issuer-ancho

celebrityanime
2026年 7月 30日

AI 工具排错

Compile bug: cuda build warning

Compile bug: cuda build warning — 该警告出现在使用 GCC 11.2 等旧版本编译器编译 llama.cpp 并启用 CUDA 后端时，可能是编译器对 std::vector::insert 主机端代码的误报。优先排查编译器版本，升级至 GCC 12+ 即可消除。

celebrityanime
2026年 7月 30日

AI 工具排错

api_websocket has no storage volume mount, so the documented empty SECRET_KEY generates divergent keys and websocket auth fails

当在 Docker 中使用空的 SECRET_KEY （默认留空）启动 Dify 的 collaboration profile 时， api_websocket 容器缺少共享存储卷挂载，导致各容器自动生成的密钥不一致，JWT 签名验证失败。优先检查 docker-compose.yaml 中 ap

celebrityanime
2026年 7月 30日

AI 工具排错

Upgrade from 1.15.0 to 1.16.1 : Data Synchronization Issue

升级 Dify 从 1.15.0 到 1.16.1 后，工作流页面持续显示「同步数据中，只需几秒钟」（Data Synchronization Issue）且不消失。优先排查 Celery Worker 并发数是否过低（建议设为 10），并尝试清除 Redis 缓存重启。

celebrityanime
2026年 7月 30日

AI 工具排错

Error 404 when creating a bot, error occurs when binding the Notion knowledge base, unable to normally jump to the binding page.

此报错通常发生在通过 Docker 自托管 Dify 并修改了默认端口（如 80 → 8080）后，点击运行 bot 或绑定 Notion 知识库时因 URL 配置未同步导致 404 错误。优先排查 docker-compose.yml CONSOLE_API_URL 、 APP_WEB_URL 等

celebrityanime
2026年 7月 30日

AI 工具排错

ImportError:` precisely so the flashinfer fusion path stays optional. The guard does not fire here because the failure is an `AttributeError`

该报错发生在 vLLM CPU 测试环境中，由于部分融合算子（`rms_norm_static_fp8_quant` 等）只在 CUDA 或 ROCm 下注册，而 CPU 导入路径缺乏防护（未使用 `hasattr` 或 `try/except`），导致 `AttributeError`。优先排查是

celebrityanime
2026年 7月 30日