Dify Agent插件调用超时：PluginDaemonInternalServerError: killed by timeout

错误链路全景

这是一个3 层架构的超时杀进程错误：

 复制代码Plugin (Python) ──[SSE]──▶ Plugin Daemon (Go) ──[HTTP]──▶ Dify API (Python)
                              │
                          ⏱️ 计时器
                        (600s 默认)

第 1 层 — 根源：Plugin Daemon (Go)

错误消息 "killed by timeout" 来源于 langgenius/dify-plugin-daemon 仓库的 Go 代码，它出现在两处：

Go 端的关键逻辑：

 复制代码// 伪代码示意
timer := time.NewTimer(time.Duration(maxExecutionTimeout) * time.Second)
select {
case <-timer.C:
    // 超时 → 杀死插件进程，返回错误
    writeData(InternalServerError("killed by timeout"))
case <-done:
    // 正常完成
}

第 2 层 — Dify API 客户端转换

在 base.py 中，当 Daemon 返回 HTTP 500 时：

 复制代码# 第 266 行
except httpx.HTTPStatusError as e:
    if e.response.status_code < 500:
        raise PluginDaemonClientSideError(...)
    else:
        raise PluginDaemonInternalServerError(description=str(e))

然后 _handle_plugin_daemon_error 方法（第 380 行）根据错误类型名反序列化：

 复制代码case PluginDaemonInternalServerError.__name__:
    raise PluginDaemonInternalServerError(description=message)

最终错误格式为：req_id: 15279e8a2e PluginDaemonInternalServerError: killed by timeout

第 3 层 — 消费方

• endpoint.py：在 delete_endpoint() 中捕获 PluginDaemonInternalServerError，用于区分"真的错误"和"已删除"（幂等删除逻辑）
• provider.py：将 PluginDaemonInternalServerError 映射为重试/降级策略

超时控制点

有两个独立的 600 秒超时配置，含义不同：

配置文件位置：

根因总结

req_id: 15279e8a2e PluginDaemonInternalServerError: killed by timeout 表示：

1. Agent 执行时间超过了 PLUGIN_MAX_EXECUTION_TIMEOUT（默认 600 秒 / 10 分钟）
2. Plugin Daemon (Go) 的计时器先于插件完成触发
3. Daemon 杀死了插件子进程
4. Daemon 向 Dify API 返回 HTTP 500，错误消息为 "killed by timeout"
5. Dify API 将其转换为 PluginDaemonInternalServerError

可能的原因：

• Agent 的 LLM 调用特别慢（如模型响应时间长、被限流）
• Agent 需要多轮工具调用，每轮积累后总耗时超过 600s
• 工具调用本身执行缓慢（如外部 API 响应慢）
• 插件进程资源不足导致执行缓慢
• PLUGIN_MAX_EXECUTION_TIMEOUT 设置过小（默认 600s）

解决方案方向：

1. 增大超时：在 docker-compose 环境变量中调大 PLUGIN_MAX_EXECUTION_TIMEOUT（如 1200）
2. 减小 Agent 执行复杂度：减少最大迭代轮数、使用更快的模型
3. 检查工具性能：排查 Agent 使用的工具是否存在慢调用