From 709ef436f7f50ff1c33fdb3a056af5c475640c3c Mon Sep 17 00:00:00 2001 From: Ryan Baxter Date: Mon, 15 Oct 2018 13:52:12 -0400 Subject: [PATCH] Added documentation about how to use the retry filter with the forward protocol. Fixes #356 --- docs/src/main/asciidoc/spring-cloud-gateway.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/src/main/asciidoc/spring-cloud-gateway.adoc b/docs/src/main/asciidoc/spring-cloud-gateway.adoc index 95a8fda0..052af641 100644 --- a/docs/src/main/asciidoc/spring-cloud-gateway.adoc +++ b/docs/src/main/asciidoc/spring-cloud-gateway.adoc @@ -773,7 +773,10 @@ spring: statuses: BAD_GATEWAY ---- -NOTE: At this time a URI using the `forward` protocol does not support using the retry filter. +NOTE: When using the retry filter with a URI that uses the `forward` protocol, the endpoint you forward to should +not return a `ResponseEntity` or else the retry filter will not be able to retry the request do to the response +already being committed in the exchange. Instead the endpoint should throw an exception and the retry filter +should be configured to retry on that exception. == Global Filters