Kong 3.0.0添加upstream-timeout插件提示“无此插件”如何解决？

核心原因 #

Kong 3.0.0 版本不包含upstream-timeout内置插件，该插件是从 Kong Gateway 3.1.0 版本开始才正式作为 bundled 内置插件引入的。你参考的官方文档针对的是更高版本的 Kong，因此在 3.0.0 中无法直接使用该插件。

解决方案 #

方案1：升级 Kong 到 3.1.0 或更高版本 #

升级后，upstream-timeout 会作为 bundled 插件默认可用，无需额外修改 KONG_PLUGINS 环境变量，直接按照你原本的配置方式添加插件即可生效。

方案2：在 Kong 3.0.0 中实现等效功能（无需升级） #

如果暂时无法升级，可以通过 Kong 原生的实体配置实现相同的上游超时控制：

• 针对服务（Service）配置超时：如果该路由关联的服务需要统一设置超时，直接修改服务的超时参数：

  service:
    name: my-service
    fields:
      protocol: http
      host: your-upstream-host
      port: 80
      read_timeout: 2147483646  # 对应插件的 read_timeout 配置
      connect_timeout: 60000     # 可选：连接超时，默认60s
      send_timeout: 60000        # 可选：发送超时，默认60s
  

• 针对上游（Upstream）配置超时：如果多个服务/路由共享同一上游，直接在 Upstream 中配置：

  upstream:
    name: my-upstream
    fields:
      read_timeout: 2147483646
      connect_timeout: 60000
      send_timeout: 60000
  

补充说明 #

你尝试将upstream-timeout添加到KONG_PLUGINS环境变量无效的原因是：该插件的代码并不存在于 Kong 3.0.0 的安装包中，环境变量只是用来控制加载哪些已存在的插件，无法“凭空”启用不存在的插件。

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