From 064f2cfcad70e2cb95d2c2c3a96b33585a5ce7af Mon Sep 17 00:00:00 2001 From: moying2026 Date: Thu, 11 Jun 2026 23:51:06 +0800 Subject: [PATCH] docs(ext-plugin-post-resp): clarify HTTP-only upstream limitation Add caution notes to both English and Chinese documentation explaining that ext-plugin-post-resp only works with HTTP upstreams since it uses lua-resty-http internally. Incompatible with gRPC transcoding and other non-HTTP upstream response flows. Fixes #13394 --- docs/en/latest/plugins/ext-plugin-post-resp.md | 6 ++++++ docs/zh/latest/plugins/ext-plugin-post-resp.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/docs/en/latest/plugins/ext-plugin-post-resp.md b/docs/en/latest/plugins/ext-plugin-post-resp.md index 29dd9fbc79e5..2f6e07bdd173 100644 --- a/docs/en/latest/plugins/ext-plugin-post-resp.md +++ b/docs/en/latest/plugins/ext-plugin-post-resp.md @@ -35,6 +35,12 @@ The `ext-plugin-post-resp` plugin will be executed after the request gets a resp This plugin uses [lua-resty-http](https://github.com/api7/lua-resty-http) library under the hood to send requests to the upstream, due to which the [proxy-control](./proxy-control.md), [proxy-mirror](./proxy-mirror.md), and [proxy-cache](./proxy-cache.md) plugins are not available to be used alongside this plugin. Also, [mTLS Between APISIX and Upstream](../mtls.md#mtls-between-apisix-and-upstream) is not yet supported. +:::caution + +Since this plugin uses `lua-resty-http` to send HTTP requests to the upstream, it only works with HTTP upstreams. It is not compatible with non-HTTP upstream response flows such as [grpc-transcode](./grpc-transcode.md). Using this plugin with gRPC or other non-HTTP protocols may lead to unexpected behavior. + +::: + See [External Plugin](../external-plugin.md) to learn more. :::note diff --git a/docs/zh/latest/plugins/ext-plugin-post-resp.md b/docs/zh/latest/plugins/ext-plugin-post-resp.md index e4cacbe4cad8..8fdaf9c4b109 100644 --- a/docs/zh/latest/plugins/ext-plugin-post-resp.md +++ b/docs/zh/latest/plugins/ext-plugin-post-resp.md @@ -42,6 +42,12 @@ description: 本文介绍了关于 Apache APISIX `ext-plugin-post-resp` 插件 如果你想了解更多关于 External Plugin 的信息，请参考 [External Plugin](../external-plugin.md) 。 +:::caution + +由于本插件使用 `lua-resty-http` 向上游发送 HTTP 请求，因此仅适用于 HTTP 上游。它不兼容非 HTTP 的上游响应流程，例如 [grpc-transcode](./grpc-transcode.md)。将此插件与 gRPC 或其他非 HTTP 协议一起使用可能会导致意外行为。 + +::: + :::note External Plugin 执行的结果会影响当前请求的响应。