[fix] httpbp middleware doesn't flush chunked responses

httpbp/middlewares.go

@@ -394,9 +394,10 @@ func recordStatusCode(counters counterGenerator) Middleware {
 	return func(name string, next HandlerFunc) HandlerFunc {
 		counter := counters.Counter("baseplate.http." + name + ".response")
 		return func(ctx context.Context, w http.ResponseWriter, r *http.Request) (err error) {
-			wrapped := &statusCodeRecorder{ResponseWriter: w}
+			rec := &statusCodeRecorder{ResponseWriter: w}
+			wrapped := wrapResponseWriter(w, rec)
 			defer func() {
-				code := wrapped.getCode(err)
+				code := rec.getCode(err)
 				counter.With("status", statusCodeFamily(code)).Add(1)
 			}()
 
@@ -453,9 +454,11 @@ func PrometheusServerMetrics(_ string) Middleware {
 			}
 			serverActiveRequests.With(activeRequestLabels).Inc()
 
-			wrapped := &responseRecorder{ResponseWriter: w}
+			rec := &responseRecorder{ResponseWriter: w}
+			wrapped := wrapResponseWriter(w, rec)
+
 			defer func() {
-				code := errorCodeForMetrics(wrapped.responseCode, err)
+				code := errorCodeForMetrics(rec.responseCode, err)
 				success := isRequestSuccessful(code, err)
 
 				labels := prometheus.Labels{
@@ -465,7 +468,7 @@ func PrometheusServerMetrics(_ string) Middleware {
 				}
 				serverLatency.With(labels).Observe(time.Since(start).Seconds())
 				serverRequestSize.With(labels).Observe(float64(r.ContentLength))
-				serverResponseSize.With(labels).Observe(float64(wrapped.bytesWritten))
+				serverResponseSize.With(labels).Observe(float64(rec.bytesWritten))
 
 				totalRequestLabels := prometheus.Labels{
 					methodLabel:   method,

httpbp/middlewares_test.go

@@ -1,15 +1,18 @@
 package httpbp_test
 
 import (
+	"bufio"
 	"context"
 	"encoding/json"
 	"errors"
+	"net"
 	"net/http"
 	"net/http/httptest"
 	"sort"
 	"strings"
 	"testing"
 
+	"github.com/reddit/baseplate.go"
 	"github.com/reddit/baseplate.go/ecinterface"
 	"github.com/reddit/baseplate.go/httpbp"
 	"github.com/reddit/baseplate.go/log"
@@ -323,3 +326,156 @@ func TestSupportedMethods(t *testing.T) {
 		)
 	}
 }
+
+func TestMiddlewareResponseWrapping(t *testing.T) {
+	store := newSecretsStore(t)
+	defer store.Close()
+
+	bp := baseplate.NewTestBaseplate(baseplate.NewTestBaseplateArgs{
+		Config:          baseplate.Config{Addr: ":8080"},
+		Store:           store,
+		EdgeContextImpl: ecinterface.Mock(),
+	})
+
+	args := httpbp.ServerArgs{
+		Baseplate: bp,
+		Middlewares: []httpbp.Middleware{
+			func(name string, next httpbp.HandlerFunc) httpbp.HandlerFunc {
+				return func(ctx context.Context, w http.ResponseWriter, r *http.Request) error {
+					if flusher, isFlusher := w.(http.Flusher); isFlusher {
+						flusher.Flush()
+					}
+
+					next(ctx, w, r)
+					return nil
+				}
+			},
+			func(name string, next httpbp.HandlerFunc) httpbp.HandlerFunc {
+				return func(ctx context.Context, w http.ResponseWriter, r *http.Request) error {
+					if hijacker, isHijacker := w.(http.Hijacker); isHijacker {
+						hijacker.Hijack()
+					}
+
+					next(ctx, w, r)
+					return nil
+				}
+			},
+			func(name string, next httpbp.HandlerFunc) httpbp.HandlerFunc {
+				return func(ctx context.Context, w http.ResponseWriter, r *http.Request) error {
+					if pusher, isPusher := w.(http.Pusher); isPusher {
+						pusher.Push("target", &http.PushOptions{})
+					}
+
+					next(ctx, w, r)
+					return nil
+				}
+			},
+		},
+		Endpoints: map[httpbp.Pattern]httpbp.Endpoint{
+			"/test": {
+				Name:    "test",
+				Methods: []string{http.MethodGet},
+				Handle: func(ctx context.Context, w http.ResponseWriter, r *http.Request) error {
+					w.Write([]byte("endpoint"))
+					return nil
+				},
+			},
+		},
+	}
+
+	// register our middleware to the EndpointRegistry
+	args, err := args.SetupEndpoints()
+
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	t.Run("non-flushable-non-hijackable", func(tt *testing.T) {
+		type baseResponseWriter struct {
+			http.ResponseWriter
+		}
+
+		r := httptest.NewRequest(http.MethodGet, "/test", nil)
+		inner := httptest.NewRecorder()
+		w := baseResponseWriter{inner}
+		args.EndpointRegistry.ServeHTTP(w, r)
+
+		if inner.Flushed {
+			tt.Error("expected response to not be flushed")
+		}
+	})
+
+	// Test the a flushable response
+	t.Run("flushable", func(tt *testing.T) {
+		r := httptest.NewRequest(http.MethodGet, "/test", nil)
+		w := httptest.NewRecorder()
+		args.EndpointRegistry.ServeHTTP(w, r)
+
+		if !w.Flushed {
+			tt.Error("expected http response to be flushed")
+		}
+	})
+
+	t.Run("hijackable", func(tt *testing.T) {
+		r := httptest.NewRequest(http.MethodGet, "/test", nil)
+		w := &hijackableResponseRecorder{httptest.NewRecorder(), false}
+		args.EndpointRegistry.ServeHTTP(w, r)
+
+		if !w.Hijacked {
+			tt.Error("expected http response to be hijacked")
+		}
+	})
+
+	t.Run("pushable", func(tt *testing.T) {
+		r := httptest.NewRequest(http.MethodGet, "/test", nil)
+		w := &pushableResponseRecorder{httptest.NewRecorder(), false}
+		args.EndpointRegistry.ServeHTTP(w, r)
+
+		if !w.Pushed {
+			tt.Error("expected http response to be pushed")
+		}
+	})
+
+	t.Run("hijackable-flushable", func(tt *testing.T) {
+		type hijackableFlushableRecorder struct {
+			hijackableResponseRecorder
+			http.Flusher
+		}
+
+		r := httptest.NewRequest(http.MethodGet, "/test", nil)
+		inner := httptest.NewRecorder()
+		w := &hijackableFlushableRecorder{
+			hijackableResponseRecorder{inner, false},
+			inner,
+		}
+		args.EndpointRegistry.ServeHTTP(w, r)
+
+		if !w.Hijacked {
+			tt.Error("expected http response to be hijacked")
+		}
+
+		if !inner.Flushed {
+			tt.Error("expected http response to be flushed")
+		}
+	})
+}
+
+type hijackableResponseRecorder struct {
+	http.ResponseWriter
+	Hijacked bool
+}
+
+func (h *hijackableResponseRecorder) Hijack() (net.Conn, *bufio.ReadWriter, error) {
+	h.Hijacked = true
+	return nil, nil, nil
+}
+
+type pushableResponseRecorder struct {
+	http.ResponseWriter
+	Pushed bool
+}
+
+func (p *pushableResponseRecorder) Push(target string, opts *http.PushOptions) error {
+	p.Pushed = true
+	return nil
+}

httpbp/response_wrappers.go

@@ -0,0 +1,33 @@
+// DO NOT EDIT.
+// This code was partially generated and then made human readable.
+// This approach was adapted from https://github.com/badgerodon/contextaware/blob/4c442dfd39106512496bdd13c42c451da8ddeff3/internal/generate-wrap/main.go
+// See also https://www.doxsey.net/blog/fixing-interface-erasure-in-go/ for more context
+
+package httpbp
+
+import (
+	"net/http"
+)
+
+func wrapResponseWriter(orig, wrapped http.ResponseWriter) http.ResponseWriter {
+	var f uint64
+	flusher, isFlusher := orig.(http.Flusher)
+	if isFlusher { f |= 0x0001 }
+	hijacker, isHijacker := orig.(http.Hijacker)
+	if isHijacker { f |= 0x0002 }
+	pusher, isPusher := orig.(http.Pusher)
+	if isPusher { f |= 0x0004 }
+
+	switch f {
+	case 0x0000: return wrapped
+	case 0x0001: return struct{http.ResponseWriter;http.Flusher}{wrapped, flusher}
+	case 0x0002: return struct{http.ResponseWriter;http.Hijacker}{wrapped, hijacker}
+	case 0x0003: return struct{http.ResponseWriter;http.Flusher;http.Hijacker}{wrapped, flusher,hijacker}
+	case 0x0004: return struct{http.ResponseWriter;http.Pusher}{wrapped, pusher}
+	case 0x0005: return struct{http.ResponseWriter;http.Flusher;http.Pusher}{wrapped,flusher,pusher}
+	case 0x0006: return struct{http.ResponseWriter;http.Hijacker;http.Pusher}{wrapped, hijacker,pusher}
+	case 0x0007: return struct{http.ResponseWriter;http.Flusher;http.Hijacker;http.Pusher}{wrapped, flusher,hijacker,pusher}
+	}
+
+	return wrapped
+}